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PREFACE 



The Network Operating System (NOS) was developed by Control Data Corporation to provide the 
capability of concurrent processing of remote interactive and transaction jobs, in addition to local and 
remote batch jobs. NOS operates on CDC® CYBER 70, Models 71, 72, 73, and 74. CDC CYBER 170 
Series, and CDC 6000 Series computer systems. 

The Interactive Facility (lAF) version 1.0 is a network host software product which allows a remote 
time-sharing terminal user to enter commands (for subsystem selection, file creation, and file 
maintenance) and to communicate with an executing program. 

AUDIENCE 

This manual is written for a higher-level language programmer who has had some experience with a 
time-sharing system. An inexperienced user should refer to the Network Products Interactive Facility 
User's Guide for a tutorial introduction to lAF. 



ORGANIZATION 

This manual contains a description of the subsystems available to the user and the procedures for usine 
these subsystem capabilities. However, it does not contain programming information for the 
subsystems. This information is found in the reference manual for the specific subsystem. 

The first three sections of this manual provide an overview of lAF and its file operations and specific 
procedures for login. This information is particularly useful for an inexperienced user. Sections 4 and 5 
describe the command set available to all lAF users. Special capabilities such as program editing and job 
contro are described m section 6. The more experienced user may be interested in the ability to enter 
control statements, either one at a time or as a batch job image, from the terminal. Sections 7 and 8 
describe these features. Also described, in appendix F, are terminal definition commands, which allow 
the terminal user to change the operating characteristics of the terminal. Messages issued to the 
terminal during use of the commands and features described in this manual are explained in appendix B. 

CONVENTIONS 

Throughout this manual, the following conventions are used. 

• The word system refers to the combination of the operating system, lAF, and the network 
Which together provide the capability of user processing in a time-sharing environment. 

• @ denotes the message transmission key on the keyboard. Depending on the terminal class 
this key may be the RETURN, CR. CARRIAGE RETURN, NEW LINE. SEND, or ETX key For 
some terminal classes, the RETURN or NEW UNE key also denotes a message terminator but 
the message is kept in the terminal buffer until the corresponding SEND or ETX key is pressed 
sending all messages in the buffer to lAF. Appendix G supplies more information. lAF and the 
network respond to the @ by positioning the carriage to the first character position on the next 
line. This manual assumes that all input is terminated and transmitted with a @ 
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-^ designates the backspace character. 

The rotation CTRL/x directs the user to press the control key (which is labeled CTRL. CNTL, 
CNTRL, or similar characters) on the terminal and, while holding this key down, press the key 
fe rrei^ed ''* example, CTRL/H means the control key is pressed ^d held, and the H key 

Examples that appear in this manual of actual terminal sessions were produced on a terminal 
class 1 terminal unless otherwise specified. Uppercase characters represent terminal outout- 
lowercase characters represent user input. (However, user input that is displayed within the' 
text of this manual is shown in uppercase characters.) All terminal activity is either displayed 
TJill?^ °^ P""^^'^ °" continuously fed paper. Examples in this manual assume printing. The 
Ll!l f.^^ ^^ '" examples does not necessarily coincide with the spacing that appears on the 
user s xerrninfiiB 

JiSfoSIm^v ^™^^'"''i"'^t.^^*'' FORTRAN Extended Version 4 (under FTNTS subsystem) 
and FORTRAN Version 5 (under FORTRAN subsystem). 

f5!"^!^„"I!!?'°ry ^"^ ^H^^'X^^^^ I'^P' ^°^^^' 171. 172. 173, 174, 175, 720, 730, 750, and 760, is 
ro;;'A-rfi''o,^^'""?^^ '"^''i' f^^«"°^ memory for CYBER 170. Model 176 is large central 
memory (LCM) or large central memory extended (LCME). In this manual ECS refers to all 
forms of extended memory on the CYBER 170 Series. 



RELATED PUBLICATIONS 



The following manuals contain additional information for the user. NOS Manual Abstracts is an 
mf n!foiT ""T^ l}^l ''"l*^'"' ^ ^"^^ description of the contents and intended audience of every 
manua documenting NOS and its product set. The abstracts manual mav be useful in determininffihi 
manuals would be of greatest interest to a particular user. ' aeierminmg whi 
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GENERAL DESCRIPTION 



INTRODUCTION 

NOS is a powerful software system that satisfies a wide spectrum of computational needs. Its mass 
storage and advanced file maintenance techniques permit large amounts of information to be acceied at 
high speeds. The system is inherently secure, since it assumes that any file (set of informatfonrbetoSs 
exclusively to the user creating it and denies any other user's request to access it. However ^u2 can 
specify that a file be made available to other users. luwever, a user can 

l^Os'wUlZT^'c^Tr. T"' P''°"'^?V'^^ interactive terminal user with the time-sharing capabilities of 
NOS. With lAF NOS can be accessed from any location. The conversational capabilities of lAF permit 
users to debug their programs much faster than with less interactive batch access modes. Also lA™«p 
ue useu irom lerminais m remote locations, thereby eliminating travel to the computer site by allowing' 
users to work in their own offices. ^ auowing 

lAF interfaces with a network software package (called the network) to communicate with terminals 
The network provides a standard communication system. It also allows a large variety of terminal tvoes 
h'TtT^""'^*^ ""'^^ ^^^ ^^ translating input from different terminal types into standard inpu formes 

This manual distinguishes network functions from lAF functions to aid in error checking and to allow the 
user to carry over knowledge of the network to other products (RBF and TAF). Even so, the networl^ 
interface js largely invisible to the lAF user. In most cases, the user can ignore the existence of the 
flvIlhl^'JftZiri" communication as with lAF. However, certain commands (appendix F) are 
^h«nl thiVh . "T "^^r""^ l""""^^^ communication only with the network. These network commands 
ntTfl ^^«™f;«'-f «;S °f « terminal (for example, changing the backspace character or initialing 
paper tape operations), change the character code set of a terminal, and send messages to the local 
operator. Unlike lAF commands, these network commands can be used any time a data path exists 
between the terminal and the system, including prior to the completion of login. 

TERMINALS 

itLT* the network provide support for 15 terminal classes. Each terminal class corresponds to an 
actual terminal or terminals as follows: ^ 



Class 


Terminal 


1 


M33, M35, M37, M38 teletypewriters 


2 


CDC 713-10 


3 


Reserved for future use 


4 


IBM 2741 


5 


M40 
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Class 


Terminal 


6 


Hazeltine 2000 


7 


CDC 751-1 


8 


Tektrwiix 4000 


9 


HASP Protocol 


10 


200 User Terminal 


11 


CDC 214 


12 


CDC 711-10 


13 


CDC 714 


14 


CDC 731-12, 732-12 


15 


CDC 734 



St J TK "^''ib'^ty of the network, a computer site may provide support to terminals other than those 
listed The user should consult local site personnel to determine if terminal types not listed are 
supported and to obtain additional operating instructions for supported nonstandard terminals 

Associated with each terminal class are specific terminal operating characteristics. Default values are 
hsted in appendix FA site can change these default values. If it does, it should provide users wUh a Ust 
fJl^ "^11 "^i"^'; J.^ "'^'' ^"" "^^ ^'^^"S^ ^^••'"*"«1 characteristics with the TRMDEF command 
larV'f^^^rma^l1eSSL'i"^^ ^°^^-^^ '^^'-'^^ ''' '-^--^ characterisSltch may 

• Backspace character. 

• Cancel character. 

• Interruption character. 

• Termination character. 



SUBSYSTEMS 

^^5E^ Description 

^^^«^ Allows communication between users at interactive terminals. A 

validated user can determine the terminal number of an interactive 
termina at which another user is logged in and send messages to that 
terminal. 



1-2 
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BASIC 



Batch 



Execute 



NuU 



Description 

Provides an elementary programming language used for scientific 
applications. This language is quickly adaptable to the needs of 
engineers, businessmen, educators, and other professionals. It requires 
neither a computer background nor training in higher mathematics. 

Provides the user with a batch control statement capability from the 
terminal. This subsystem enables a user to type, at a terminal, control 
statements that normally would have to be entered from a card reader at 
the central site or from a remote batch terminal or would have to be 
meluded in a procedure file or job submitted to the central site. 

Allows a user to execute a previously compiled program. Since 
compilation accounts for a majority of the time spent on a job, not 
havmg to recompile a program each time provides an efficient means of 
running a frequently used program. 

Translates mathematical language into machine language to solve 
mathematical and engineering problems. The FORTRAN subsystem 
(using the FORTRAN Version 5 compiler) or the FTNTS subsystem (using 
the FORTRAN Extended Version 4 compiler) provides a convenient 
language for expressing mathematical and scientific problems and a 
convenient method for data input and output. 

Allows the user to perform file manipulations and other time-sharing 
(derations without subsystem association. 



INPUT/OUTPUT CONVENTIONS 

The foUowing input/output (I/O) conventions and standards apply to an lAF terminal. 



LENGTH OF INPUT/OUTPUT LINES 

A logical input or output line can consist of a maximum of 150 characters. The physical output line can 
be any length. If the user attempts to output more characters than the current page width t allows the 
additional characters are placed on the next line. hiwws, tne 



NETWORK MESSAGES DURING INPUT 

The foUowing diagnostic messages can appear during input from the terminal. 
Message Description 



REPEAT. 



Due to a temporary overload condition, the network has discarded the 
last logical line of input. The user should re-enter this information. 



t This characteristic varies, depending on the terminal class. It can be changed using the TRMDEF 
command (section 4; or one of the terminal definition commands (appendix F). 



I 
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Message 



Description 



I 



INPUT STOPPED message Due to a system overload condition, the networi< cannot accept terminal 

input. The user should wait until the message INPUT RESUMED is issued 
before proceeding. Message is a text string defined by the site. 

INPUT RESUMED The system overload condition has cleared. The user can resume 

terminal input. 

FROM LOP...message A message has been sent by the local operator. The user can respond to 

this message by entering the message (MS) command described in 
appendix F. 

^^^" T^^ "ser entered a terminal definition command that contained either a 

format error cm* a parameter invalid for his terminal type or not 
supported at his site. 



TERMINATION OF INPUT LINE 

The user must terminate each Une of input information by pressing @ . This tells the network and lAF 
that the current input line is complete. The network responds by positioning the carri^e at the 
beginning of the next line. The user can then enter additional input information on the new uJe. 

CORRECTION OF INPUT LINE 

The user can correct entry errors in the input line, before pressing @, by using the backspace 
character.? One character (including spaces) is deleted for each backspace character entered If the 
SSins ' " '''''''• '"'■''''■ '^"'^'^^ '""'''''^'^ ^'' ^^"°'-' <^- f °^ ^' a "pS When the input 

BAX-*-SJK^-^IC 

it is interpreted by the system as the BASIC subsystem selection command (or a line of text interpreted 
as the word BASIC, if the user is in text mode). interpretea 

DELETION OF INPUT LINE 

When the user discovers an error in the command or other input before pressing @ he can delete the 
CtTi" /xTtV "}' h' ^"l^""g Jlif ^«"«^' «"« <^haracter t followed by @. For moVt termTnals th^ s 
CTRL/X or the ( character. Default values for each terminal class arVgiven in appendix F. 



It This characteristic varies, depending on the terminal class. It can be changed usine the TRMDFF 
command (section 4) or one of the terminal definition commands (appendix F). ^ TRMDEF 
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l^ZI^^I'Z\rT"^~ i"" '^^ cancel line character by priming *DEL* on the next line and positioning the I 
ch^^te ^«e'""^ne of a new line. The following example illustrates the use of the cancel Une | 



READY. 
10 program t(output) 
20 print 6 

30 6 format 9*this is a test 
•DEL» 

30 6 format (»this is it*) 
40 end 
Inh 

10 PROGRAM T(OUTPUT) 

20 PRINT 6 

30 6 FORMAT (»THIS IS IT«) 

40 END 

READY. 



INPUT TO EXECUTING PROGRAM 

tl °!i!?"* *° ^^^ terminal normally indicates that the executing program has requested input. However 
the program may include question marks in its normal output. Terminal definition commands can be 
entered m response to any input request, for example, when the user is in text mode or is using Text 
Editor or XEDIT. If a terminal definition command is entered following a request for input a new 
question mark is not sent to the terminal. 



PAGE WAIT 

Each terminal class defines a certain number of lines of output as a page.t For a display terminal with 

S. £l.rf J^ °"i'?"' ''°Pf ^'.^^""^ P^^ boundary To display the next page, the user either must I 

ZZ§ f h' r te>-m,na s, the control character t and @. For a printing terminal with page wait I 

enabled, the system inserts six line feeds at each page boundary and output continues. If output ceases I 

m ivi 1 1 ic ni6ss8£r6 ' 



OVER. 



LtS^bylntedng®. °^ '^' °"^^"'' "^'^^ *^^ P'"'""' ^^^ '' "°* ^""' «"°**^"'" ^"^^ ^^^^s and can be 



t This characteristic varies, depending on the terminal class. It can be changed using the TRMDEF 
command (section 4) or one of the terminal definition commands (appendix F). 
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SNTERRUPTION OF EXECUTING PROGRAM 

To interrupt an executing program, the user enters the interruption character t followed bv ^ The 

laZTrt CtTlTp' CTrI' fT'^'.l''' T'" 'T' ^ ^T^""^' ^°' "^^^^ '''^'^^''' '"^^ in'e^uptiSn 
Character IS CTRL/P, CTRL/F, or the : character. Default values for each terminal class are eiven in 
appendix F, lAF responds with the message i ■"•"«! i-iabb are given m 

♦INTERRUPTED* 

If output is being transmitted to the terminal when interruption is desired, the user must perform an 
additional procedure: he must first press the BREAK key (sometimes labeled INT, INTRPT orTpTN) to 
suspend terminal output. He can then enter the interruption character to interrupt the program 
Synchronous terminals do not have a break character. To interrupt output on these terminals p^e wait 
bTila?L's " '"'"''■ "^'^ ^"^^'■'■"P«°" ^«^"-"<^- ««n then be entereS only when output cSs^efatp^e 



NOTE 



On asynchrcxious terminals (terminal classes 1 
through 8), output can be suspended by pressing 
any key. However, then the interruption sequence 
cannot be entered. To use the interruption 
sequence, the BREAK key must be used to suspend 
output. 

TERMINATION OF EXECUTING PROGRAM 

S-ifw"^^® ^" executing program, the user enters the termination character t followed by®. The 
chara'cte °£ C?r17t o^ fhX'h 1 T Tf^^f 2 sequence. For most terminals, the te^JiiiTatilS 
ifp "SrSs w™ (L mfj^^^ °''^"" ^^^"^^ '°^ ^^^^ '''^'^^' ^^^- -^ ^-- - appendix F. 

♦TERMINATED* 

If output is being transmitted to the terminal, the user must first suspend terminal outout as described 
previously, and then enter the termination sequence. lermmai output as described 

USE OF ATTN ON IBM 2741 TERMINALS 

Users of IBM 2741 terminals must press the ATTN key before entering the terminal definition control 
character cancel character, abort line character, interruption character, or ^itlon character For 
further information about these characters, refer to appendix F. "unauon cnaracter. I'or 



t This characteristic varies, depending on the terminal class. It can be chaneed usins the TRMnPF 
command (section 4) or one of the terminal definition commands (appenSx ?). ^ TRMDEF 
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CONTROL SYTES 

lifoT'cZrA^ interactive program to control terminal activity by including control bytes in his 
3e1£gSTerte'iS.rmS;''"''"^ ^"^' '' ^°"*'''^"*"^ '""^ ^^*"°"*"^ ^' ^'^^ ^^-^-^ ^'--^ -'^ 

tcm^^S^^'^euJr^^^^^ *" ^'* P°'*''°" °' '^' 24. 36. or 48 of a central memory 

VOm; word. The user must be careful since data can be mistaken for a control byte. For examole thP 

wrtnf T%? \yP^.«t the beginning of a line and followed by an end-of-line may log out theSr'i 
TvalSe '"'"'' °"''"' '•'"' ''""" "^^ '"^^ °°°' '^ transmitted. TTie followin^g control bytes a- 

"^yte Description 

0001 I 

or } End-of-block 

0002 



0004 
0005 
0006 



Auto input 

Log out user 

Initiate ASCII input mode 

Initiate transparent input mode 
^^^^ Initiate transparent output mode 

^^^^ Initiate ASCII output mode 

0013 End-of-string 

0016 Terminal redeiKjition 

The use of these control bytes is described in detail in the NOB Reference Manual, volume 2. 
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LOGIN AND LOGOUT PROCEDURES 



iNTRODUCTiON 

This section describes the foUowir^ topics, 
c The login procedure. 

• The logout procedure. 

• Application switching. 



The user cannot harm the system by making incorrect entries or other mistakes at the terminal. 
Mistakes can have only diagnostic consequences; that is, they only produce error messages (usually 
ILLEGAL COMMAND or ERR..) and do not damage the operating system, lAF, or the network in any 
way. Generally, the user is allowed as many chances as necessary to make a correct entry. However, if 
he is unsuccessful at login four times in succession, the terminal is automatically disconnected. If this 
happens, the user should check his user name, family, password, and procedures and try again. 

LOGIN PROCEDURE 

The procedure has three basic steps. 

Step Description 

Preparation The user gathers information he needs before login. 

Terminal to network The user connects the terminal to the network. 

connection 

Login sequence The user identifies himself as a valid user of the network and of lAF. 



PREPARATION 

Before attempting to connect the terminal to the network, the user must have the answers to the 
following: 

• What are the characteristics of the terminal being used? These should correspond to a 
particular terminal class described in appendix F. 

• How is the terminal coupled to the computer (data set, acoustic coupler, or hardwired)? 

• If the terminal is not hardwired, what is the phone number of the line that corresponds to the 
class of terminal being used? 
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• What is the family name? Every user is associated with a family. 

• What is the user name? Everyone must have a user name to gain access to the network and lAF 
at login. The user name is called the user number in some other manuals. 

• Is there an associated password? If so, this password must be used along with the user name to 
gain access to the network and lAF. 

• Are charge number and project number required? If so. it is also necessary to enter a valid 
charge number and project number to gain access to lAF. 

TERMINAL TO NETWORK CONNECTION 

2l,le^e.^'lSrS^aS-^^''°'""' ^^ '*^^ *^^ ''°""''''* ^^^ terminal to the network prior to the login 

• Checking switches^ 

• Dialing in. 

• Identifying terminal. 

The following paragraphs describe these steps; figure 2-1 summarizes them. Consulting the manual 
supphed with the terminal can be helpful in identifying the terms mentioned in these steps. 

Checking Switches 

To check switches, the user should do the following: 

• Find the power switch on the terminal and turn it to the ON position. 

• Does the terminal have a duplex switch? If it does, ensure that it is turned to the correct 
position for proper character echoing. This switch is normally in the HALF position since all 
released terminal classes have character echoing disabled as a default. Refer to appendix F for 
a description of enabling and disabling character echoing. at-H^nuiA r lor 

• Does the terminal have a parity switch? If it does, set it to the proper position for the class of 
the terminal. Values for each to-minal class are shown in appendix F. 

• Does the terminal have a line-speed switch? If it does, set it to the position that matches the 
speed or speed range for the line being called. "i^-ico uie 



NOTE 



The switch checking procedure varies from 
terminal to terminal. The user should consult the 
owner's manual provided with the terminal for 
instructions on properly configuring the terminal. 
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CHECKING SWITCHES 



DIAUNG IN 



Terminal with data set 



Turn power on. 

FULL duplex or HALF duplex: usually HALF. 

Parity: set switch on ASCII code terminal to 
EVEN position; set switch on 
correspondence code terminal to ODD 
position. 

Line speed: set to speed specified by site. 



Terminal with acoustic coupler 



Built into terminal 



Standalone 



Built into terminal 



Standalone 



Dial number 



1. Pick up receiver. 1. 

2. Press TALK. 2. 

3. Dial number. 3. 

4. Tone. Press DATA. 4. 

5. Replace receiver. 



Pick up receiver. 1. 

Dial number. 2. 

Tone. 3. 

Place receiver in 4. 

coipler. 5. 



IDENTIFYING TERMINAL 



Turn on coupler. 

Pick up receiver. 

Dial number. 

Tone. 

Place receiver in 

coupler. 




Press SEND for mode 4A 
terminal 

or 

Press ETX for mode 4G 
terminal 



Press @ 




Press @ 
to bypass auto 
recognition of 
character set 



Press C ATTN for correspondence 
code terminal class 4 

or 

Press E ATTN for EBCD code 
terminal class 4 



Press) @ 
to determine 
character set 
of terminal 



Figure 2-1. Login Procedure 
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Dialing In 

The dial-in procedure connects the terminal to the computer through a data set or an acoustic coupler. 
Either one may be located in the terminal or as a separate unit beside the terminal. Hardwired terminals 
are already connected to the computer so the dial-in procedure is not necessary. 

If the data set is located in the terminal, a telephwie dial is located on the terminal panel. When the 
terminal is turned on, the dial tone is heard. Dial the computer number. When the connection is made, 
the terminal is ready to begin terminal identification. 

If the data set is separate from the terminal, the user must do the following: 

1. Pick up the phone receiver. 

2. Press the TALK button on the face of the phone; the button lights. 

3. Dial the computer number. 

4. Wnen a continuous high-pitched tone sounds, press the DATA button on the face of the phone- 
the button lights. <- • • - f 

5. Replace the phone receiver. Connection is made and the terminal is ready to begin terminal 
identification. 

If the acoustic coupler is located in the terminal, it automatically turns on when power is applied to the 
terminal. If the acoustic coipler is a separate unit, it must be turned on after power is applied to the 
terminal. In either case, a standard telephone is used in the following manner. 

1. Pick up the receiver and listen for a dial tone. 

2. Dial the computer number. 

3. A continuous high-pitched tone indicates that the call has been answered and ccamection has 
been established. 

4. Place receiver in rubber suction cups of acoustic coupler with the cord at the end indicated on 
the coupler. 



Identifying Terminal 

Once the connection is established, it may be necessary to identify the terminal to the network. This is 
required on autorecognition lines, so that the network can determine the line speed and/or character 
code set of the terminal. 

Depending on the terminal type, one of the following procedures is used. 

e For mode 4A terminals, press SEND (on these terminals, the SEND key takes the place of the 
carriage return). 



e 



For mode 4C terminals, press ETX (on these terminals, the ETX key takes the place of the 
carriage return). 



2-4 



60455250 C 



For asynchronous terminals (terminal classes 1 throi^h 8), press @. The terminal operator has 
60 seconds after connection is made to press @; otherwise the terminal is disconnected. Entry 
of @ enables the system to determine the terminal's line speed. When the line speed is 
recognized, the system issues two line feeds. The user then has 60 seconds to enter either of 
the following sequences to determine the terminal's character code set. 

) @ Entry of a right parenthesis followed by carriage return enables the system to 

determine the character code set of the terminal. 

@ For standard ASCII terminals, entry of only a carriage return bypasses 

character code set recc^nition by the system. The character code set is 
assumed to be ASCII. 

If the user does not respond within 60 seconds, the terminal is disconnected. Automatic 
identification of the terminal character code set by the system can be bypassed only on a 
standard ASCII terminal. When the terminal's character code set is recognized, the system 
issues two additional line feeds to indicate that the terminal identification procedure is 
complete. The login sequence b^ins. 

Line speeds which can be recognized for asynchronous terminals are 110, 134.5 (for IBM 2741), 
150, 300 (for ASCII and IBM 2741), 600, and 1200 baud. The terminal character code sets which 
can be recognized are ASCII, typewriter-paired ASCII APL, bit-paired ASCII APL, and, for IBM 
2741 terminals only, correspondence code, extended binary-coded decimal (EBCD), 
correspondence APL, and EBCDIC APL. The mess^e 

UNSUPPORTED CODE SET 

indicates that the character code set that was recognized is not supported at the user's site. 

The user can charge his terminal character code set (usually by means of a terminal switch or 
removable type ball) any time after initial terminal identification using the CD network 
command (appendix F). 



LOGIN SEQUENCE 

When the network determines that a data path exists between the terminal and the computer, the login 
sequence begins. This sequence may vary slightly at some sites due to the flexibility of the network, but 
is normally a subset of the foUowir^. In any case, the user should only respond to the prompts issued. 

The login sequence begins with the terminal printing three lines. The first line is in the format 

yy/mm/dd. hh.mm.ss. termnam 

This information consists of the date given in the fca-mat year/month/day, the time in the format 
hour.minute.second., and a network-supplied terminal name. This terminal name is referenced internally 
by the network when sending and receiving information. It is of importance to the user if he wishes to 
communicate problems to site personnel (refer to MS command in appendix F). For example, if the login 
for the terminal identified by the system as TERM201 began at 12 minutes and 44 seconds after 2 o'clock 
in the afternoon on February 3, 1979, the first line would read 

79/02/03. 14.12.44. TERM201 
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Ttie seeoHd line ^ the Headet- IdeMtlf^lflf the site Which hiay give the Company name, the operating 
system, and the version of the operating system. For example: 

CDC MULTI-IWODE OPERATING SYSTEM. NOS 1. 

The third line is 

FAMILY: 

This line requests the family name assigned to mass storage device(s) containing the user's permanent 
files. Each system has its own family of permanent file devices. If the userls family is the default for 
the system, the user need only press @. 

FAMILY: @ 

If this login is being made into an alternate system (two or more sets of permanent file devices), the 
family name of the user's nwmal permanent file family must be entered. For example, if the user is 
assigned to family SYSA, he types on the same line 

FAMILY: SYSA 

If the user is not certain whether his family is the default family, he should enter the family name in 
respOTise to the prompt. 

The network next requests the user name (this is called the user number in some other manuals). 
USER NAME: 

The user types his user name on the same line and presses @. For example, if his valid user name is 
XX234XX, he types 

USER NAME: XX234XX 

The network then responds with a request for the password. 

P ASSWORD : 
HBHBBSia 

The second line results from the network overtyping a variety of characters. This overtyping is done only 
on hardcopy terminals and its objective is to preserve password secrecy. After creating this row of 
blackouts, the cursor moves back to the first blackout. The user enters his four- to seven-character 
password and presses @. 

If the family name, user name, and password are acceptable, the network responds 

termnam - APPLICATION: 

The termnam on this line is the same as that on the first line of the login sequence. The user selects lAF 
by typing lAF on the same line and pressing©. This might appear as follows for terminal TERM201. 

TERM201 - APPLICATION: lAF 
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" NOTE I 

lAF is selected automatically if automatic 
selection has been set in the user's validation file. 
In this case, the application prompt just described 
does not appear. The remainder of the procedure 
is the same. 



If the user is validated to access lAF, or if lAF is selected automatically, lAF displays the terminal 
number and type on the next line. For example: 

TERMINAL: 45,NAM1AF 

This is terminal 45 in the lAF configuration for ttris site. NAMIAF also indicates that the terminal is 
being processed through the Network Access Method (NAM). The user should note his terminal number. 
If he is accidentally disconnected from the system, he can attempt to recover his job and files using the 
RECOVER command and his terminal number. 

lAF immediately follows this with either 

RECOVER/SYSTEM: 



or 



RECOVER/CHARGE: 



The procedures to be used differ slightly depending on the prompt issued. However, for both form-; -<f the 
prompt (RECOVER/SYSTEM and RECOVER/CHARGE). RECOVER has the same meaning. It is used in 
special cases in which the user was already lo^ed in and was inadvertently disconnected. He can log 
back in and try to continue from where he was disconnected by typing RECOVER and the previously 
associated terminal number in response to either of the RECOVER prompts (Recovery in section 6). 

If the RECOVER/SYSTEM respaise is issued and the user is not attempting a recovery, the user enters 
the command for the subsystem to be used or any other valid command (sections 4 and 5). The following 
are the commands for calling subsystems. 



Command 
ACCESS 
BASIC 
BATCH,nnnnn 

EXECUTE 
FORTRAN 
FTNTS 
NULL 



Description 

To use the access subsystem for interterminal communication. 

To use the BASIC language. 

To enter batch control statements interactively from the terminal; 
nnnnn is optional and specifies the field length to be used (if omitted, 
is assumed and the operating system manages the field length). 

To execute a previously compiled program. 

To use the time-sharing FORTRAN Version 5 language. 

To use the time-sharing FORTRAN Extended Version 4 language. 

To perform file manipulations without subsystem association. 



60455250 C 



2-7 



When the user specifies the ACCESS command, lAF responds 
READY. 

if the user is validated to use the ACCESS command. He can then alter the DIAL or USER command 
(sectim 4). 

When the user specifies the BATCH command, lAF responds 

$RFL,nnnnn. 

/ 

nnnnn is the specified field length. 

The user can then enter an lAF command or any vaUd batch control statement up to 78 characters in 
length (section 8). 

When the user specifies the NULL command, lAF responds 

READY. 
The user can then enter any valid lAF command. 
When the user specifies the BASIC, EXECUTE, FORTRAN, or FTNTS command. lAF respwids 

OLD, NEW, OR LIB FILE: 

The user then specifies whether the file is to be a new file or a copy of an existing file. This is done bv 
enta-mg one of the following commands. 

Command Description 

^^^ For a file previously saved as an indirect access permanent file. 

NEW For a new primary file. 

LIBRARY For an indirect access permanent file that resides in the catalog of 

special user name LIBRARY. 

lAF responds 

HLE NAME: 

The user enters the file name (one to seven characters). If a file called by the OLD or UBRARY 
command does not exist, lAF responds 

pfn NOT FOUND. 

where pfn is the file name specified. The user then reenters the appropriate file command and file name. 
If no errors are detected, lAF responds 

READY. 
Any valid lAF commands can then be entered. 
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If the RECOVER/CHARGE response is issued and the user is not attempting a recovery, he types 
CHARGE followed by a valid charge number and project number. 

CHARGE.chargeno.projectno 

For greater security, the user can enter the CHARGE command with no parameters. lAF responds with 

CHARGE NUMBER: 



The user then types the charge number over the area the system has blacked out and presses @. lAF 
then requests the user's project number in the same manner. If the user's charge and project numbers are 
valid, lAF responds 

REA&Y. 

The user then enters the command for the subsystem to be used (refer to the RECOVER/SYSTEM 
procedures) or any valid command (sections 4 and 5). 



ABBREVIATED LOGIN PROCEDURE 

The user can shorten the login procedure by entering all of the login information at once. When the 
FAMILY prompt appears, the user may enter the family name, user name, password, and application on 
the same line. 

FAMILY: familyname,username,password, application 

The information entered must be separated by commas. Any default or unused parameters are indicated 
by double commas, or in the case of family name, an initial comma. For example, user XX234XX, with 
password PASSl, in the default family SYSA, can log into lAF with one of the foUowir^: 

FAMILY: SYSA,XX234XX,PASS1,IAF 
or 

FAMILY: ,XX234XX,PASS1,IAF 

When the abbreviated login procedure is used, subsequent login prompts are suppressed. 

Combined entries can be provided in response to the USER NAME and PASSWORD prompts as well. In 
all cases, although the remaining sequence need not be completed on one line, information supplied in the 
login sequence must be supplied in the proper order: family name, user name, password, application. For 
example, the following login sequence may occur. 

FAMILY: SYSA 

USER NAME: XX234XX,PA^1 

termnam - APPLICATION: lAF 

lAF can automatically select a subsystem (such as BASIC or batch) for the user at login if this has been 
specified in the operating system validation file. The validation file determines internal system controls 
associated with each valid user name. Refer to the discussion of the LIMITS command in section 4 for 
further information. 
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LOGOUT AND APPLICATION SWITCHING PROCEDURE 

When the user has finished using lAF, he can either log out or switch to another application. The logout 
procedure ends a user's session at the terminal. Application switching ends a user^ session with lAF but 
allows him to continue processing under the control of another application (such as RBF). 



LOGOUT PROCEDURE 

To leave lAF and the network, the user enters one of the foUowir^: 

GOODBYE 
or 

BYE 
or 

LOGOUT 

TTie network responds by printii^ 

user name LOG OFF hh.mm.ss. 

user name SRU s.sss UNTS. 

lAF CONNECT TIME hh.mm.ss. 

and then disconnects the terminal. The first hh.mm.ss. is the time of logout, s.ss is a measure of the 
system resources used while connected to lAF, and the second hh.mm.ss. indicates how long the user was 
connected to lAF. 

lAF automatically logs out the user if no activity has been registered in any 10-minute period, unless the 
user is validated for no-timeout terminal status. Refer to the discussion of the LIMITS command for 
further information. 

The user may wish to log out without disconnecting the terminal, to allow another person to use the 
terminal. To log the present user out of the system and reinitialize the Ic^in sequence, the user can enter 

HELLO 
or 

LOGIN 

lAF logs out the current user, issues the normal logout messages, and then automatically causes the 
network to initiate a new login sequence. "Hie new user proceeds as described earlier, starting with the 
login sequence. 



APPLICATION SWITCHING PROCEDURE 

If the user wishes to leave lAF control but remain connected to the network and use another application, 
he can enter one of the following: 

BYE,application 

GOODBYE,application 

HELLO.application 

LOGIN.application -^ .jja 

LOGOUT,appli cation 
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m the system, or ,f the user is not validated to use it, an error message is issued and the pSmpt 
termnam - APPLICATION: 

HELLO, 
the logout message is printed and the network issues the prompt 

termnam - APPLICATION: 
The user can then enter the name of an a(^lication. 
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FILE USAGE 



INTRODUCTION 



With the exception of some central memory tables, all data in the system is either a file or a part of a 
tile. This section describes mass storage file organization and explains the fundamentals of file 
processing. Refer to the NOS Reference Manual, volume 1, for detailed information concerning file 
structure. " 



FILE STRUCTURE 

A file is the largest collection of information the user can address by name (one through seven 
characters). It begins with a beginning-of-information (BOI). supplied by the system, and ends with an 
end-of-information (EOI). The system automatically writes an EOI as the last physical item of 
information on aU files. A file consists of one or more logical records or one or more logical files each 
logical file consisting of one or more logical records. i"Si<-ai lues, eacn 

if fl^."" logical record, which can be either fixed or variable in length, is a group of related words or 
characters. In this manual, it is also called a logical record or a record (refer to appendix C). A logical 

rnr r^v"^pp^ T,?' """"^ ^^^^'''^l '^""^ ""'*' ^^^"^^ «"<^ «"^^ «"th an end-of-record mark (EOR). 
CDC CYBER Record Manager may define records with different structures and may subdivide a record 
into its own record types. 

A system logical file is one or more system logical records. It ends with an end-of-file mark (EOF). 

pn^^^i I^^^ "x *u!^^ ^"""^ l^^ "^^^ *° '""'"^ *°S'^^^ ^°^ '"«'''« °" a file (for example, XEDIT and 
i-UKTRAN). In this way, a file actually becomes a multifile file as shown below. 

(BOI)...data...(EOR)...data...(EORKEOF)...data...(EORXEOFXEOI) 

A PRU is the smallest division of data on a device, and its size depends on the device. On all mass 
fim3 K^Vr'' ^ f ^",-^ ^^° ^"^'1 characters (64 central memory words). The size of a file in PRUs is 
wh-!h th^r^^ ""^^^ validation (refer to UMITS Command in section 4) and the mass storage device on 
which the file resides (refer to appendix D). 

The following is a typical file. 

One line of an invoice forms an item, a complete invoice forms a record, a set of such records forms 
a tile, and the collection of invoice files forms a multifile file. 

If a file is positioned at BOI, and the user enters a read operation, the system reads the first logical 
record. If the user enters a write operation, the system starts writing data on the first PRU and 
terminates the logical record with an EOR and EOI. If the file is positioned at EOR or EOF and the user 
enters a read operation, the system reads the next record, EOF, or EOI. If the user enters a write 

FoTl!.°F^p frf" ^'^•^' *''!.''^*^'^?. ^^^' ^"^ ^" ^^' ^° « "^* Pf^y^i^^l '•^«°'^ following the current 
EOR or EOF A file positioned at EOI is positioned at the last physical record of the file. If the use^ 
enters a read operation when a file is positioned at EOI, the system reads the EOI and transmits no data 
U the user enters a write operation, the system writes over the existing. E^r a^d adds a ne-v lotyion] 
record to the file followed by an EOR and EOI. '" " •' ^- """^^^ ^ "^"^ ^°&"^«^ 
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THe following examples illustrate possible positions within a file. 



Filel 



File 2 



File 3 



S 

a 



1 



data.,.(EORXEOFXEOI) 



.data...(EOR),..data...(EORKEOF). 



m 



...clata...(E0RXEOI) 

El H H 

File positioned At BQL 

File positioned at EOR. 

File positioned at EOF. 

File positioned at EOl. 

File positioned at intermediate point in data. 



RESERVED FILE NAMES 

Several file names have special significance to the system. In some cases, the system considers these 
file names to be reserved. In other cases, use of these file names causes unpredictable results. The user 
should take care when using these file names. The message 

RESERVED FILE NAME 

indicates that the user has attempted to use one of these file names illegally. 

The reserved file names are: 



INPUT 


SCRl 


OUTPUT 


SCR2 


PUNCH 


SCR3 


PUNCHB 


SCR4 


P8 


ZZZZZxx 


SCR 





ZZZZZxx means that any file whose name begins with ZZZZZ is reserved. Other products used with NOS 
also reserve file names for internal use. TTie user should consult the reference manual for the product he 
is using for additional reserved file names. 
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TEMPORARY AND lOCAL FJLtS 

SH"^ ^" J^^ terminal session, the user can create new files and use existing (permanent) files 
Permanent files are either indirect access or direct access files (refer to seSfion 5 for a full descriotion 
of ,nd>rec and d.rect access files and the commands used to manipulate them When the ,^er aceeS" 
an indirect access file, a copy of the file is made; all changes are made on the coov rather ton thP 

'fr^nZ tSVire'^" *'' ""''' ^^^^"^^ ' '""'^^ ^'^^^^^ ^"' ' - -Py '^ ZT^JlToZZ^'Zl^l 

ZVJ^riZ\TS\lV'^T^Z\ZT "t "'^ '''"P°™'"^ ■" "^^"'•^^ ^^^* ''' they «ease to exist when 

ine user logs out of lAF. To retain them, the user must save or replace the files. In this manufll « n^w I 

file or a copy of an existing indirect access file is called a temporary file. ' I 

ijf^fif!^ ^ ^"^ ^^^ currently assigned to the job. This includes temporary files as previously described I 
and direct access permanent files that are currently attached to the job. previously described I 

One type of temporary file, the primary file, has special significance in certain lAF commands A 
primary file is a new file created with the NEW or PRIMARY command or a copy of an eSin^ indir*>ct 
access nprmnn'^n* fii" ™t,.;«..,,^ ,..:♦!, *k_ <->» r^ .^ t t,,^ . — . v^uiiuauu ui a ^.^n}y oi an existing indirect 

o»o,1okL V^*k" " re-.-.-- ".Lh uic Guu or uiDa.H.a.x command. Only one primary file is active or 

available to the user at any given time. For example, the command ^ 

old,lfn1 

p";maT4!7tt'c"^L"'a^^"" '^^'"^""^ "'^ ^'^^ ''•°'" P^^^"-* «1« «t-«^« f- - - the 
old,lfn2 

is entered, a copy of indirect access permanent file LFN2 is retrieved for use as the nrim«p« fii« c.r,H fh« 
previous primary file (LFNI) is released. To access LFNl again. t'heliTrst'Jeenter^S^L^LFm^ ''' 

get.lfnl 

V'Zr,ZTy 'm^ii2TZlTtS:;r.l!'' ^^^^ ^ -^-^-^ ^- -- - « --^--^ «le. but the 

Most operations performed on files by lAF commands are performed on the primary file unless another 
local file IS specified in a command parameter. For example, the command 

save 
retains the primary file in the permanent file system. However, the command 

save.abc 
fempSrarSTffle.^ '" *''' permanent file system. File ABC could be either the primary file or another 



60455250 C 

3-3 



There is a close association between the E»riiTiary file and the subsystem in use when the primary file is 
saved. Unless the null subsystem is active when the primary file is saved, or unless SS=NULL is specified 
in the SAVE command, the system sets an internal indicator called the subsystem flag indicating which 
subsystem is in use. That subsystem is associated with the permanent file and is automatically selected 
each time the file is retrieved for use as the primary file. For example, if a user operating under the 
BASIC subsystem issues the command 

save,abc 

where ABC is the current primary file name, the BASIC subsystem flag is associated with resulting 
permanent file ABC. When the user is subsequently operating under another subsystem and enters the 
command 

old ,abo 

the current primary file is released, the BASIC subsystem is selected automatically, and file ABC 
becomes the new primary file. To save the primary file without a subsystem association, the user must 
either enter the null subsystem before issuing the SAVE command or include SS=NULL in the SAVE 
command. Retrieving a file saved under the null subsystem does not affect the subsystem in use. The 
subsystem flag is set only when the user saves the primary file, or when he enters the SAVE or CHANGE 
command with the SS parameter. If the permanent file named in the command to select a new primary 
file does not have a subsystem associated with it, the subsystem currently being used remains in effect. 

Before any operation ai a primary file, the file is automatically rewound (positioned at BOl). However, 
the user i? responsible for the positicm of all other local files because they are not automatically rewound 
before each operation. The REWIND command from an lAF terminal, the REWIND statement in 
FORTRAN, or the RESTORE statement in BASIC can position a file to BOI. 

Information (program statements, text, or data) entered from the terminal keyboard is normally stored in 
the primary file. However, the user can also enter information into any local file, including the primary 
file, or create new local files using Text Editor or XEDIT. (The Text Editor and XEDIT commands are 
listed in appendix E.) Refer to the Text Editor Reference Manual or the XEDIT Reference Manual for 
additional information. 



FILE SORTING 

lAF sorts a file by line numbers; a file without line numbers cannot be sorted. The user can enter line 
numbers manually or can use the AUTO command to generate them (refer to Terminal Ccsitrol 
Commands in section 4). The line numbers generated by the AUTO command consist of only five digits. 
When creating a file, the following rules apply. 

• Each line of information entered into a primary file must begin with a line number, unless the 
user is in text or transparent input mode or is using Text Editor or XEDIT. 

• Each line of information must have a space between the line number and the information, unless 
the user is entering a BASIC program. 

• Line numbers for FORTRAN and BASIC programs cannot be more than 5 digits; line numbers for 
all other lines of information can be up to 10 digits. 

9 licading '-.os on line numbers are permissible but are not required (00120 and 120 are 
interchangeable). Line numbers with leading zeros can be intermixed with line numbers 
contairiing no leading zeros. 
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LIST, LNH, RUN^REPLACrRNH.!EVSlH\mTTED?T S^^^ "^^"^^^ t"^- 

procedure file call is made. Sorting places tf^.tifimfSI" ' ' ^^^^" command is entered or a 

digits of the line numbers. To sS the fiS iSfnJ mo>S th«n' th"T^7^r ^ "S'^^r ^^^^'•^•"S ^^ ^^e first five 
be specified usin, the SORT.lfn eomm'aS m^S'^arTmltlr) deSrS in^ecS^l^'^^ """'^'" °' '''''' «^" 

^^n^^^t^S^fiJ -;---- -^^ number followed b. 

toiiling space are retained. (TOe RESEQ command retains at m J ™ f ', '''"'^ """ """= '""" »"« 

.rerr;™'e;"i:r ?^»^TeS:,?;r„rLrrf:ot;i,:e^ -r-r '^^ ''«--«■ ^'- 

entire input is stored as one logical recopi ° """"^ "^ "" "«"" ««>"'• T^"s. the 

11 the message 

FILE TOO LONG TO SORT. 

.1,e"Sw?i'::S Sl^ri^^'^S "■ >» ^"^ automaticaiiy by ,AP. T„e user must then enter 



land before proceeding, 
However, if the message 
FILE NOT SORTED. 



Ifh^oirm^ircla-ract'ert :rnrT£sTso?t\t ^ o^^f ^ Tl T' ^"^ ^ -- «- begin 
The user may enter the SORT.lfn commanSt; mS^SXma^fv: dTagnostTcs.''^ "'* ''^ "^^ ^^^«'-«^- 

^hLn^mLrcTea^VriirrC and s^Sb'^e^^ntrTonl!; "^ 'T^' ^"^^^ ^^« ^°«°«^ — ^• 
not be sorted and packed into onTlSl^Jford The 1^ f j"^^" ^''t "'r ^^^''""^ ^^^^ ^^e primary file 
numbered line of source code folIoS theTosbR? crmmaS """"' "''" ''''' ''^"•""^ *''« «•■«*' 

The foUowing example illustrates the effect of the NOSfiRT «^„,™ ^ rT,^ 

subsystem and obtains a copy of permane^ me A^St^LmlTdtqu'^^^cr'" "'"'^ ''' '"^'' 
ftnts,old,a 

subsystem and flie h.ve'^een .elSeT?hete? ent™s thrclSini " '"'""""' *= ""''' 

enquire 
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lAF prints the following status report. 

TERMINAL: 7, NAMIAF-* Identifies the terminal being used. 

SYSTEM : FTNTS « Proper subsystem was selected. 

FILE NAME : A •* File A is the new primary file. 

STATUS: IDLE 

MESSAGE:-* No message is printed when the status is idle. 

The user then requests a listing of the file with the command 

list 

lAF prints the followii^ copy of the file. 

79/07/25. 07.48.51. 
PROGRAM A 

00100 PROGRAM TEST (OUTPUT) 

00110 DO 1 J=1, 10 

00120 PRINT 2, J 

00130 2 FORMAT (2X,I2) 

OOUO 1 CONTINUE 

00150 STOP 

00160 END 

READY. 
The user then enters the following changes. 

00120 k=j«j 

00130 print 2,k 

00140 2 format (2x,i2) 

00150 1 continue 

00T60 stop 

00170 end 

The user then enters the command 

nosort 
lAF respcMKis 

READY. 
The user then calls for a listing with logical record indications by entering the command 

list,r 
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!AP lists the unaoHiri m^, inmmng the end of aaeh logical record. 

79/07/25. 07.50.25. 
PROGRAM A 

00100 PROGRAM TEST (OUTPUT) 

00110 DO 1 J=1, 10 

00120 PRINT 2, J 

00130 2 FORMAT (2X,I2) 

001 40 1 CONTINUE 

00150 STOP 

00160 END 

— EOR— 

00120 K=J«J 

00130 PRINT 2,K 

00140 2 FORMAT (2X,I2) 

00150 1 CONTINUE 

00160 STOP 

00170 END 

— EOR— 

READY. 

If the user requests a Usting without entering the NOSORT command, the following output is produced. 

79/07/25. 07.50,49. 
PROGRAM A 

00100 PROGRAM TEST (OUTPUT) 

00110 DO 1 J=1, 10 

00120 K=J«J 

00130 PRINT 2,K 

00140 2 FORMAT (2X,I2) 

00150 1 CONTINUE 

00160 STOP 

00170 END 

—EOR— 

READY. 

SlltSg com^n"?^ "'''' '"""'"^ *'' ^''' *° '" P"°'^ *"^° °"^ ^°Sical record, the user enters the 

pack 
To then perform text editing on the packed file, the user calls the Text Editor or XEDIT (section 4). 



B0455250 C 

3-7 



I LOCAL FiLI CONTROL 

The OLD, NEW, and LIBRARY commands change the status of temporary files by releasing the file 
currently designated the primary file and substituting another file in that status. When the OLD 
command is entered, the existing primary file is released and a copy of an indirect access permanent file 
becomes the new primary file. When the NEW command is entered, the existing primary file is released 
and a new primary file is created. The user can then write data into that file from the terminal. When 
the LIBRARY command is entered, the existing primary file is released and a copy of an indirect access 
permanent file, saved under the special user name LIBRARY, becomes the new primary file. 

When the existing primary file is released by entry of the OLD, NEW, or LIBRARY command, all other 
local files are also released unless ND (no drop) is specified with the command. The following is a list of 
sample commands and their effect on files. 



Files Present at Completion of Command 



Commands 

BASIC.OLD.A 

GET,B 

GET.C 

ATTACH.D 

FTNTS.OLD.Al (local files are dropped) 

RUN (program Al creates TAPED 



Primary 


Other Local Files 


A 




A 


B 


A 


B,C 


A 


B,C,D 


Al 




Al 





RUN COMPLETE. (lAF response) 



Al 



TAPEl 



GET.Bl 


Al 


TAPEl.Bl 


GET.Cl 


Al 


TAPEl.Bl.Cl 


SAVE.TAPEl 


Al 


TAPEl.Bl.Cl 


FTNTS.0LD.A2/ND (local files are 


A2 


TAPEl ,B1,C1 


retained by using ND parameter) 






RUN (program A2 creates TAPE2) 


A2 


TAPEl.Bl.Cl 



RUN COMPLETE. (lAF response) A2 TAPE1,TAPE2,B1,C1 

Other commands that change the status of local files are: 

I BYE GOODBYE LOGIN RETURN 

CLEAR HELLO LOGOUT 

Each command releases some or all local files depending on the format of the command used. The logout 
commands (BYE, GOODBYE, HELLO, LOGIN, and LOGOUT) release all local files. Different forms of 
the CLEAR and RETURN commands allow the user to return specified files, all files, or all files except 
those ^eeified in the command. Section 4 contains complete descriptions of these commands. 



3-8 



60455250 C 



(A(= COMMANDS 



INTRODUCTION 

Aiter the user has successfully logged into lAF, he can enter the commands necessary to process his job. 
The four general categories of commands available to the user are: 

• Terminal control commands. 

• Subsystem selectioi commands. 

• Job processing commands. 

• Permanent file commands. 

The first three categories are discussed in this section. Permanent file commands are described in 
section 5. 



COMMAND PROCESSING 

The minimum number of characters required to specify a command depends upon the specific command 
and the subsystem currently being used. Three characters are the minimum number checked when a 
command is entered in all subsystems except the batch subsystem. In the batch subsystem, commands 
cannot be abbreviated. In all subsystems if more than the minimum number of characters are entered 
lAF checks the number given, up to a maximum of seven characters. 

For example, if a user is operating under the BASIC subsystem and wants to change to FTNTS the 
following are legal and illegal commands for entering FTNTS. 

Legal Forms fllegal Forms 

FTN F 

FTNT FT 



PTNTS FTNx (x is any alphanumeric character except T) 

However, if the user is in the batch subsystem and wants to change to any other subsystem, the name of 
that subsystem must be entered without abbreviation. 

In general. lAF processes each command by checking from one to seven of the characters entered If the 
user does not enter a sufficient number of characters to make the command unique, lAF responds 

COMMAND NOT UNIQUE. 

and the user must then reenter the command using n sufficient number of characters to make it unique 
I his only occurs with commands in which the first several characters are identical, such as HRF.P and 
HRLLO. in this case, the entry of HEL would result in the command being declared not unique. 
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If the commahd entered is not a valid command or is misspelled, the message 

ILLEGAL COMMAND, 
is returned. The command entered can be up to 80 characters. A longer command causes the message 

COMMAND TOO LONG. 

to be issued. lAF prefixes many commands with a $ if they are to be passed on to the operatir^ system 
for processing. This is done to identify them as lAF commands and to prevent the system from trying to 
locate and execute a local file of the same name. In these cases, the 80th character of the command 
entered by the user is truncated. When the user discovers an error in the command or other input before 
@ is pressed, he can either delete the entire line or backspace to the point of the error, correct it, and 
continue on the same line. 

To delete a line, the user first presses the cancel line character (refer to appendix F for default cancel 
characters for aU terminal classes) and then the@. T^e network responds by printing *DEL* on the next 
line and positioning the carriage to the first character position of a new line. 

To back^ace and correct a line, the user counts the number of characters (including spaces) to the 
position of the error and presses the backspace key an equal number of times. The user then corrects the 
error and continues on the same line. The backspace key depends on the terminal class (refer to appendix 
F) but is usually the BACK SPACE key, -*-key, or CTRL/H keys. 

If the user attempts to perform an operation for which he is not validated or if he exceeds his validation 
limits, lAF responds 

ILLEGAL USER ACCESS. 

The system maintains validation controls for every user name (refer to LIMITS Command at the end of 
this section for a complete description). 

Alphabetic characters entered in lowercase are automatically translated to uppercase unless the ASCII 
command is in effect. The ASCII command inhibits translation from lowercase to uppercase. All 
commands may be entered in uppercase or lowercase in either ASCII or normal character mode. 

On all commands that require a numeric value, the number is treated as follows: 

• If the number contains an eight or nine, decimal base is assumed. 

• The base may be specified by a postradix of B or D; that is, 562D is treated as 562 decimal and 
562B is treated as 562 octaL 

• Default conversion of numbers is normally decimal. 
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Command 



ASCII 



TERMINAL CONTROL COMMANDS 

The terminal control commands allow the user to change the characteristics of the terminal and to varv 
^«n r."onL^.25 ^"^""^^^.^ mfwmation given to and received from the system. These commands, which 
can be entered at any time after the user has successfully logged into lAF. are as follows: 

Description 

Allows the user of an ASCII terminal to use the ASCII 128-character set 
and places the terminal in ASCII mode. On non-ASCII terminals this 
command allows the use of up to 128 of the characters defined for the 
terminal. The ASCII command allows the user to enter lowercase letters 
that are interpreted by the system rather than translated to uppercase as is 
done in normal mode. 

In ASCII mode, characters entered from the terminal are translated into 
6/12 display code. On an ASCII terminal, 6/12 display code consists of 95 
graphic characters and 33 control characters (the 128-eharacter set). The 
standard AsuII graphic 64-character set contains only the first 64 (or 63 
depending on an installation option) of these 95 characters. In normal 
mode, the user is restricted to these 64 (or 63) characters. Characters of 
the ASCII graphic 64-character set are processed internally as 6-bit display 
code characters. The additional characters that make up the ASCII 
128-character set are processed internally as 12-bit display code 
characters. Refer to appendix A for further info-mation on display codes 
and character sets. 

lAF receives all ASCII characters except line feed, carriage return. NUL 

EOT, DEL, and the lexical backspace character. Control characters (line 

feed, cancel line, and backspace) are not received unless in special editing 

mode. Commands can be entered in either uppercase or lowercase 
regardless of ASCII mode. 

Automatically generates five-digit line numbers. The nnnnn parameter 
specifies the beginning line number; default value is 00100. The iiii 
parameter specifies the increment value added for each succeedine line 
number; default value is 10. 

'^ exit from auto mode, the user presses the cancel line key followed by 
<&, thus deleting the current line. A new command can then be entered on 
the next line. 



AUTO.nnnnn.iiii 



The hne numbering sequence can be altered by deleting tlie line or 
backspacing and then entering a new beginning line number rather than a 
new command (leading zeros are permissible but not required). The user 
should exercise caution when doing this since the AUTO command is still in 
effect and continues generating line numbers using the original increment 
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Command Description 

value. Thus, if a line number is generated that already exists in the file, 
the original contents of that line are lost and must be reentered. The 
increment value cannot be altered unless a new AUTO command is entered. 

In the following example of the AUTO command, the user deletes a line 
number to change the numbering sequence and then deletes another line 
number in order to place a character in column 6. 



READY, 
auto 

00100 program headerdnput, output) 
00110 write 1000 

00120 (User enters cancel line character.) 
»DEL» 

00230 1 000 format ( 1 5x , "head ings* ) (User enters entire line.) 
00240 write 2000 

00250 2000 formate 15x, "author*, 9x,»title»,15x, 
00260 (User enters cancel line character.) 
•DEL* 

00260+ *publisher*,6x,*cost*) (User enters 

00270 stop entire line.) 

00280 end 

00290 (User enters cancel line character.) 
•DEL* 
Inh 

00100 PROGRAM HEADER (INPUT, OUTPUT) 

00110 WRITE 1000 

00230 1000 F0RMAT(15X,^HEADINGS^) 

002M0 WRITE 2000 

00250 2000 F0RMAT(15X, •AUTHORS, 9X,»TITLE»,15X, 

00260+ •PUBLISHER*, 6X, •COST*) 

00270 STOP 

00280 END 

READY. 



BRIEF Sippresses all full and partial headers such as those issued by the LIST or 

RUN command. 
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CSET.c 



Description 

Sets the character set mode of the terminal to the specified mode. 

c Specifies terminal character set mode. 

ASCII Set ASCn mode (ASCn 128-character set). 

NORMAL Set normal mode (ASCII graphic 64-character 
set). 

The CSET command may also be entered through control statements 
included in a procedure file. 



NOTE I 



me i^oci.nunmAL command affects only the 
terminal character set, not its auto oe brief states. 



NORMAL 



TIMEOUT 



TRMDEF,L=lfn, 

tci=V2,..., 

tCn=Vn 



Reverses the effect of the ASCII, AUTO, BRIEF, CSET, and 
NOSORT commands on both input and output. lAF initially 
assumes that this command has been entered. Normal mode 
uses the ASCII graphic 64-character set. All lowercase letters 
are converted to uppercase (refer to ASCII command) and all 
command headers are printed (refer to BRIEF command). 

Changes a no-timeout terminal to the standard timeout status. 
In standard timeout status, the user is automatically logged out 
after 10 minutes of inactivity. Standard status is in effect 
when bit 10 in access word AW is clear. (Refer to LIMITS 
Command in this section.) When the bit is set, the terminal 
remains connected until the user logs out. The TIMEOUT 
command clears this bit for the session in progress. 

Changes one or more of the characteristics of a user's 
terminal (for example, the termination character or page 
width). The terminal characteristic to be changed, tc,, is 
specified by a two-character mnemonic listed in table F-1 in 
appendix F. Almost all of the parameters available for terminal 
definition commands can be used in the TRMDEF command. 
(Exceptions are DL and some IN parameters as noted in 
appendix F.) The new value, v,, is any value in the range given 
for that terminal characteristic in table F-1. It can be a 
decimal value, a coded value with a special meaning (such as PR 
for printer), or a single character. If the new value is a single 
character, it can be given in any of the following formats. 

Value Description 

V Any alphanumeric character (a character with a 

display code in the range 0<display code < 443). 

$v$ Any character, including special characters, 

delimited by dollar signs (for example, $*$). If the 
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Value Description 

character is a dollar sign ($), it must be specified 
using two dollar signs (for example, $$$$). 

vwB Octal value of an ASCII character (for example, 

52B, which would be equivalent to an entry of $*$). 

vvD Decimal value of an ASCII character (for example, 
42D, which would be equivalent to an entry of $*$). 

Xvv Hexadecimal value of an ASCII character (for 
example, X2A, which would be equivalent to an 
entry of $*$). 



If a numeric value for a single ASCII character is 
specified without a pre- or post-radix, the value is 
assumed to be octal unless it coitains an 8 or 9. In 
this case, it is translated as decimal. 



The L parameter specifies an optional file on which the 
terminal redefinitioi information is written. If omitted, file 
OUTPUT is assumed. If another file is specified, the changes 
are implemented when the file is listed or copied to the 
terminal. 

If the user is accessing any application other than lAF, entry of 
the TRMDEF command has no effect. If any errors are found in 
the command, a messe^e is issued and the terminal charac- 
teristics in effect before entry of the command remain in 
effect. 



Example: 

TRMDEF,IN=PT 



This command changes the input 
device to a paper tape reader, thus 
allowing the user to read data and 
commands from a tape. It has the 
same effect as the corresponding 
terminal definition command (that is, 
entry of the control character 
followed by IN=I>T). 
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SUBSYSTEM SELECTION COMMANDS 

The following commands are used to select a i^ecific subsystem. The user should always be 
aware of the subsystem that is currently active. For example, attempting to execute a 
FORTRAN program while operating under the BASIC subsystem causes meaningless 
diagnostic messages to be issued. To determine which subsystem is currently active, enter 
the ENQUIRE command. 



NOTE 



The subsystem may be automatically selected by 
lAF at login if this has been set in the validation 
nie. 



^Jtf\^->^kn\^ •3uL/ojrobdii ecu 






L»e associaieu wun an inuireet access file so that whenever the user specifies 
that file as the primary file, the associated subsystem is selected automatically. The subsystem 
associated with a file is set when the file is saved. If the user includes the SS (subsystem) parameter on 
the SAVE command, he can specify any of the valid subsystems. If he enters SAVE without the SS 
parameter and the file is the primary file, the subsystem currently active is set. To save the primary file 
with no subsystem association, either the user can enter the nuU subsystem before he saves the file or he 
can enter the command ' 



SAVE,lfn/^=NULL 

Automatic subsystem association is made only when the primary file is saved. To associate a subsystem 
with a temporary file other than the primary file, it must be saved with the SS parameter specified. 



Command 



ACCESS 



Description 

Selects the access subsystem. While in the access subsystem, the user can 
communicate with another interactive terminal using the DIAL and USER 
commands, TTie user must be validated to use the access subsystem (refer 
to LIMITS Command). If the user has the proper validation, lAF responds 

READY. 
Otherwise, the message 

ILLEGAL COMMAND. 
is returned. 

The DIAL and USER commands can be entered only when the access 
subsystem is active. 
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Command Description 



BASIC.ccc Selects the BASIC subsystem. The optional ecc parameter enables the user 

to specify one command in addition to the BASIC command. Any valid 
command is permitted, as well as all valid parameters for that command. 
The following example illustrates the use of this option. 

BASIC.OLD.PRIME 

In this example, the user selects the BASIC subsystem and makes 
p«-manent file PRIME the primary file. The file name (PRIME) is a valid 
parameter with the OLD command. 

If ccc is omitted and no primary file is currently defined, lAF responds 
OLD, NEW, OR LIB FILEi 

The user can then specify whether the primary file is to be a new file 
(NEW) or an existing indirect access permanent file (OLD or LIB). UB is an 
abbreviation of the command LIBRARY (refer to section 5). The file name 
(separated by a comma) also can be included in this entry. The entry is 
terminated by @ . If the file name is omitted in the reply, lAF responds 

FILE NAME: 

The user then specifies the file name. 

BATCH.nnnnn Selects the batch subsystem. Refer to secticMi 8 for a description of this 

command. 

EXECUTE.ccc Selects the execute subsystem. This subsystem is used only to execute a 

previously compiled (object code) prc^ram. The RUN (or RNH) command 
must be entered to initiate execution. The optional ccc parameter enables 
the user to specify one command in addition to the EXECUTE command. 
Any valid command is permitted, as well as all valid parameters for that 
command. The following example illustrates the use of this option. 

EXECUTE.OLD.OBJnLE 

In this example, the user selects the execute subsystem and makes 
permanent file OBJFILE the primary file. The file name (OBJFILE) is a 
valid parameter with the OLD command. 

If ccc is omitted and no primary file is currently defined, lAF responds 
OLD, NEW, OR LIB FILE: 

The user can then specify whether the primary file is to be a new file 
(NEW) or an existing indirect access permanent file (OLD or LIB). LIB is an 
abbreviation of the command LIBRARY (refer to section 5). The file name 
(separated by a comma) also can be included in this entry. The entry is 
terminated by @. If the file name is omitted in the reply, lAF responds 

FILE NAME: 
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Deseription 
The user then specifies the file name. 



Source language programs cannot be executed under 
the execute subsystem. 



FORTRAN.cce 



The execute subsystem should be used whenever possible to conserve 
system resources. Efficiency can be achieved when certain programs are 
used frequently. For example, a source code program created under 
FORTRAN must first be compiled before it can be executed. This process 
is automatic. The user need only enter the RUN command. The program 
automatically goes through a compilation phase which produces an 
executable object code (binary) program. The object code program is then 
executed. Thus, greater efficiency is achieved by retaining the object code 
program in the permanent file system for later execution under the execute 
subsystem. This can be accomplished by using the following commands. 



RUN,B=lfn 



SAVE.lfn/ 
SS=EXECUTE 



Causes the object code program to be placed on 
temporary file Ifn. 

Retains file Ifn as a permanent file and sets 
the execute subsystem flag. 



If this is done, subsequent requests to the file using the OLD command 
cause the execute subsystem to be selected. Entering the RUN command 
initiates execution of the object code program. 

Selects the FORTRAN subsystem, which uses the FORTRAN Version 5 
compiler. The optional ccc parameter enables the user to specify one 
command in addition to the FORTRAN command. Any valid command is 
permitted, as well as all valid parameters for that command. The following 
example illustrates the use of this option. 

FORTRAN,OLD,TAX 

In this example, the user selects the FORTRAN subsystem and makes 
permanent file TAX the primary file. The file name (TAX) is a valid 
parameter with the NEW command. 

If ccc is omitted and no primary file is currently defined, lAF responds 
OLD, NEW. OR LIB FILE: 

The user can then specify whether the primary file is to be a new file 
(NEW) or an existing indirect access permanent file (OLD or LIB). LIB is an 
abbreviation of the command LIBRARY (refer to section 5). The file name 
(separated by a comma) also can be included in this entry. The entry is 
terminated by (g). If the file name is omitted in the reply, lAF responds 

FILE NAME: 
The user then specifies the file name. 
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FTNTS.ccc Selects the FTNTS subsystem, which uses the FORTRAN Extended Version 

4 compiler. The optional ccc parameter enables the user to specify one 
command in addition to the FTNTS command. Any valid command is 
permitted, as well as all valid parameters for that command. The following 
example illustrates the use of this option. 

FTNTS,OLD,DATAGEN 

In this example, the user selects the FTNTS subsystem and makes 
po-manent file DATAGEN the primary file. The file name (DATAGEN) is a 
valid parameter with the OLD command. 

If ccc is omitted and no primary file is currently defined, the system 
responds 

OLD, NEW, OR LIB FILE: 

The user can then specify whether the primary file is to be a new file 
(NEW) or an existing indirect access permanent file (OLD or UB). LIB is an 
abbreviation of the command LIBRARY (refer to section 5). The file name 
(separated by a comma) also can be included in this entry. The entry is 
terminated by @ . If the file name is omitted in the reply, lAF responds 

FILE NAME: 

The user then specifies the file name. 

NULL Selects the null subsystem. lAF responds 

READY. 

This command is entered before saving the primary file if the user does not 
want a specific subsystem flag to be associated with the file. Normally, 
when a user saves the primary file, an internal indicator called the 
subsystem flag is set to indicate the subsystem currently in use. That 
subsystem is automatically selected in each succeeding request for the file 
using the OLD command. An alternate way of saving the primary file with 
no subsystem association is to specify the SS=NULL parameter on the SAVE 
command (section 5). 

If the user does not specify a subsystem at login time, lAF sets the 
subsystem ^ecified in the validation file (refer to the IS field under LIMITS 
Command in this section). Null is the default. 
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JOB PROCESSING COMMANDS 

The job processing commands allow the user to perform a variety of job processing or job-related 
operations. These commands can be entered at any time after the login to lAF is complete. 



Command 



APL 



BEG lN,pname,p file, 

P1.P2.— .Pn 
or 
-pname.pfile.pi, 
P2.— .Pn 



Description 

Selects the APL (A Programming Language) interactive interpreter. To 
take advantage of the full capabilities of APL (including the character set), 
this command can be used in conjunction with the SE and CD terminal 
definiticm commands (refer to appendix F). 

Initiates processing of a CDC CYBER Control Language (CCL) proce- 
dure. This allows the user to process a procedure file and re- 
main interactive with his job. 

A procedure is a source file that contains control statements and/or control 

laneruaffe statements, it hav the como efmmt..^^ „„ *k~ i_-i _.._!, 

" - — -^ — «...v, ^m,,_>.v,it ao iiic umiuui .simeiiieni 

record m a normal batch job, although the job statement and USER 

statement required in batch jobs cannot be included. Although the 

command format and short parameter descriptions are given here refer to 

the NOS Reference Manual, volume 1, to obtain further information about 

CCL procedures and a listing of CCL dayfile messages. 

The pname and pfile parameters are order dependent. If the user does not 
specify a parameter, a default value is asumed. Parameters dj are 
optionaL ' 

pname Name of the procedure to be processed. The default is the 
next procedure on file pfile. If the default Is used, and pfile 
IS at end-of-information, CCL rewinds pfile and calls the first 
procedure. An exception occurs if pfile is input: in this case 
pfile is not rewound. ' 

pfile Name of the file on which procedure pname is located. The 
default is a site-defined file name (currently the default is 
file PROCFIL). CCL first searches for a local file named 
pfile. If pfile is not local, CCL searches for an indirect 
access file named pfile and does a GET to make it local. 

Pi A parameter having one of the followir^ forms. 

Order dependent forms: 



fk 



fk= 



A formal keyword that is the same as a 
keyword used in the procedure header 
statement. This can be used to specify an 
alternate value substitution. 

Specifies null substitution for the formal 
keyword fk which appears in the procedure 
header statement. 

A value of from 1 to 40 characters, or null. 
To include nonalphanumeric characters, 
except slash or leading minus, v must be a 
literal ($-delimited). 
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Order independent form: 

fk=v The value v is substituted for the formal 
keyword fk which appears in the procedure 
header statement. 

To call procedure pname on file pfile, CCL searches for file pfile and then 
for procedure pname. If either pfile or pname is not found, the job step 
aborts. 

To create a CCL procedure file from the terminal, the user enters text 
mode (refer to the TEXT command), uses Text Editor (refer to the EDIT 
command), or uses XEDIT (refer to the XEDIT command). A CCL 
prdcediire file cannot contain line numbers. After leaving text mode, the 
user can retain the file for future reference by using the SAVE command. 
The user can make changes to the procedure file using Text Editor or 
XEDIT. An example of CCL procedure file creation is given in the 
description of the TEXT command in this section. 

BYE,applieatiOT Ends a user's session with lAF and either Ic^s him out of the network and 

disconnects the terminal or places him under the control of another 
applicatiwi (such as RBF or TAP). 

application Optional parameter specifying an application to 

which the user wishes to be connected. Control Data 
supplied applications can be specified by entering 
TAP or RBP, If the application is available and the 
user is validated for that application, the user is 
automatically released from lAF cc«itrol and placed 
under the control of the named application. If this 
parameter is not specified, the user is logged out of 
the system and the terminal is disconnected. In this 
ease lAF responds by printing 

usemam LOGOFF hh.mm.ss. 

usemam SRU s.sssUNTS. 

The network then prints 

lAF CONNECT TIME ho.mi.se. 

usemam User name. 

hh.mm.ss. Time of day this command was 
entered. 
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S'Sss Measure of system resources 

used during lAF connection. 
The SRU is a unit of 
measurement which includes 
all CPU time, memory usage, 
and I/O activity since login to 
lAF. 

ho.mi.se. Length of time the user was 

connected to lAF. 



NOTE I 



^n K^ 



The user should ensure that all temr>ora!n' fi!t„ , ^^ 

retained are made permanent before issuing this 
command. All files not saved are released when the 
BYE command is processed. 



CALL,lf n Initiates processing of KCL (a control language supported under previous 

operatmg systems) procedure file Ifn. This allows the user to process a 
procedure file and remain interactive with his job. 

A procedure file is a source file which contains control statement images 
and/or control language statements. It has the same structure as the 
control statement record in a normal batch job althoigh the job and USER 
statements required in batch jobs cannot be included. 

Optional parameters may also be included in this command. The command 
format with options is 

CALL,lfn,C,S=ccc(oldnami=newnami,oldnam2=newnam2,..., 
oldnamn=newnamn) 



Ifn 
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Specifies name of the procedure file to be processed. 
The system searches for Ifn according to the fol- 
lowing indicated order. 

1. Current local files (including primary file). 

2. System-defined procedure files. This can 
be a procedure file created by the site and 
included as part of the system. 

3. User's permanent file catalog for indirect 
access permanent file. File must not have 
an associated password. 

If the specified file cannot be found, the system 
responds 

Ifn NOT FOUND. 
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^^mand Deseription 

C Replaces the control statement record after the 

CALL command with Ifn. 

S=ecc Specifies control statement ccc as the first 

statement in the procedure file to he executed. 

oldnamp Directs that oldnam be replaced with newnam for 
newnamj each occurrence of oldnam in the procedure file. 

This allows use of the same procedure file to perform 
several tasks, depending on the parameters specified. 

To create a procedure file from the terminal, the user enters text mode 
(refer to the TEXT command), uses Text Editor (refer to the EDIT 
command) uses XEDfT (refer to the XEDIT command), or enters auto mode 
refer to the AUTO command). Lines within a procedure file may contain 
hne numbers to make maintenance easier. However, the CALL command 
removes the line numbers before the procedure file is processed. The 
PACK comrnand compresses the file into one logical record (necessary only 
with text mode). The file can be retained for future reference as an 
indirect access permanent file by using the SAVE command. If the user 
wants to change the procedure file he must use Text Editor or XEDIT 
unless the file has line numbers. Editing files with line numbers is 
explained in section 6 under Program Editing. 

Refer to the NOS Reference Manual, volume 1, for information concerning 
the control statements and control language statements available. 

^nnoSS'"'^''^^""' i^"^'^^ *^^ "^^^ ^° ^^'^•fy ^ ^«"^ ""^^Se number and project num- 

projectno ber to be billed for subsequent terminal operations. Certain users are 

required to enter a charge and project number during the lc»in sequence- 
all users may issue the CHARGE command as long as the charge and 
project numbers entered are valid. This command can be entered at any 
time during the timesharing session. Both charge number (chargeno) and 
project number (projeetno) parameters are required. The number of -^vstem 
resource units (SRUs) the system used in processing the CHARGE command 
IS printed at the terminal in the BASIC, FORTRAN, FTNTS, or execute 
subsystem. In the batch subsystem, the last entry in the usage summary is 
printed at the terminal. In all subsystems, the job SRU accumulator and 
usage summary are written on the user's dayfile, and the SRU accumulator 
IS set to zero. The SRU is a unit of measurement which represents the 
total usage of the system by the user. It includes all CPU time, memory 
usage, and I/O activity. lAF responds "^looiy 

READY. 

For greater security, the user can enter the CHARGE command with no 
parameters. Refer to Login Sequence in section 2 for more information on 
system response. 
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Command 
CLEAR or CLEAR,* 



CLEAR,*,lfni, 
lfn2i...,lfnn 

CONVERT 



DAYHLE.options 



Description 

Releases aU local files including the primary file. All files to be retained 
must be made permanent before entering this command. 

Releases all local files except Ifni Ifnn. 

Converts input from one character set to another. Conversion can be from 
63- to 64-character set, or from old time-sharing record (61-character set) 
to new time-sharmg record (63- or 64-character set). Refer to appendix A 
for a complete description of the CONVERT command and information on 
character sets. 

Causes lAF to reply with an abbreviated status response. 

IDLE. User has no job active in the system. 

EXECUTE. User's job is currently being processed. 



WAIT. 



User's job is waiting for computer resources to 
become available. 



When output has stopped on a page boundary (refer to the terminal 
definition commands PL and PG in appendix F) the @ does not cause a 
status response. In this ease. @only causes the network to send the next 
page of output to the terminal. , 

Lists the system record of the user's time-sharing activity. Each line of 
output IS m the form 

hh.mm.ss. mess^e 

hh.mm.ss. Time of day the message was placed in the dayfile. 
The formats of the command are 

DAYFILE,L=lfn,FR=string,OP=op (order independent) 

or 
DAYFILE, Ifn.string.op (order dependent) 

L=lfn Specifies file on which the dayfile is to be 

written. If L=lfn is omitted, LOUTPUT is 
assumed and the dayfile output is listed at the 
terminaU 



I 
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Command Description 



FR=string Specifies the literal stringt the system is to 

search for in the day file. If the string 
contains any characters other than letters 
and numbers, including leading and 
embedded blanks, it must be enclosed by $ 
delimiters. Any $ within the string must be 
replaced with two $'s. 



* A literal string is n sequence of characters. 



I NOTE ] 

lAF commamfe written to the dayfile 
are preceded by a $. Hence, the $ 
preceding the command must be 
replaced with two $'s, and the command 
must be enclosed by $ delimiters (for 
example, $$$OLD$). 



The system searches for the strir^ only at the 
beginning of the field specified by the OP 
parameter. The portion of the dayfile from the 
last occurrence of the requested string to the 
end of the dayflle is printed at the terminal or on 
the file named. TTie first character of the time 
field is a space. 

OP=op Specifies the starting field position; op can be 

one of the following: 

T Searches the beginning of the time field 
for a matching string. 



M 



Searches the beginnii^ of the message 
field fw a matching string. 



I Lists the dayfile from the last 
occurrence of the message USER 
DAYFILE DUMPED. The string 
parameter cannot be specified. 

F Lists the entire dayfile if no string 
parameter is specified; searches the 
beginnir^ of the message field if a 
string is specified. 

If the OP parameter is omitted and the FR 
parameter is specified, OP=M is assumed; 
otherwise, OP=F is assumed. 
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Command 



Description 



Examples: 



DAYnLE,TEMP,COMPASS 



DAYFILE„$ 09.41.23.$,T. 



DAYFILE,OP=I 



DAYFILE,DAY,$$$FTN$. 



DAYFILE„$$$BEGIN$. 



The system searches the beginning of 
the message field for the string, 
COMPASS, and lists the day file, 
starting at the last occurrence of the 
string, on file TEMP. 

The system searches the beginning of 
the time field for 09.41.23. and Usts the 
dayfile from that time at the terminal. 
There is a blank preceding the time in 
the time field. 

The system prints the portion of the 
vjajruxc iiuL iisieu (previously a I tne 
terminal. 

The system searches the beginning of 
the mess^e field for $FTN and lists the 
dayfile, from the last occurrence of 
$FTN, on file DAY. 

The system lists the dayfile from the 
last time the lAF command BEGIN was 
used. 



DEBUG.option 



Activates, terminates, or resumes CDC CYBER Interactive Debug. When 
activated, it aids the user in debugging compiled programs. One of the 
tollowing options can be specified. 



Option 

ON 

OFF 

RESUME 



Description 

Activates debug mode; is the default option. 

Terminates debug mode. 

Resumes debug session suspended by the last 
execution of the DEBUG SUSPEND command. 



DIAL,nnnn,sss 



^t'"^^^^^'""^^ information on the use of the debug mode, refer to the 
CYBER Interactive Debug Reference Manual. 

Sends one-line message sss to the terminal specified by terminal number 
nnnn. The DIAL command can be entered only if the access subsystem is 
active. The terminal to receive the message can have any subsystem 
active; it need not be under the access subsystem or have access validation. 

The user determines the appropriate terminal number using the USER 
command. If the terminal specified is currently receiving output or ha 
input request outstanding, the message is lost. No further attempt to 
transmit the mossage is made. If the message is sent succesf^fullv lAF 
responds "j^, mr 

READY. 



s an 



(iii4r)r)2r)() <^ 
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Command Description 

EDIT.optiwis Selects Text Editor. 

The formats of the command are 

EDIT,FN=lfni,M=m,I=lfn2,L=lfn3 (order independent) 

or 

EDIT,lfni,m,lfn2.1fn3 (order dependent) 

FN=lfni Specifies the name of an existing local file to be 
edited. The FN parameter may also specify a new 
temporary file name, fii this ease, the new file is 
constructed using Text Editor. If the FN parameter 
is omitted, the primary file name is assumed.t When 
necessary, the primary file is sorted prior to text 
editing. 

M=m Selects mode of file processing. 

ASCII ASCn mode edit file. This 

or parameter indicates that the 

AS user wishes to process the file in 

ASCII mode. The terminal is 
automatically put in ASCII mode. 
After editing is completed, the 
terminal is put back in its original 
mode. 

NORMAL Normal mode edit file, 
or 

N 

If omitted, normal mode is assumed. Li a 
time-sharing session if a terminal is in ASCII mode, 
the system adds an AS to all EDIT commands when 
the EDIT statement is entered with no parameters or 
only Ifnj (not FN=lfni). This does not apply to EDIT 
statements in procedure files or EDIT statements 
with more than one positional parameter. 

I=lfn2 Specifies file from which EDIT commands are to be 

read. If omitted, commands are input from the 
terminal. 

L=lfn3 Specifies file from which output is to be written. If 

omitted, output is returned to the terminal. 



t If two or moi-e parameters are specified ir; the command, or if an equated parameter is u^i-a 
name of the file to be edited must be specifien (the p^-imary file is not assumed). 
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Command 



Description 



I NOTE I 

Before entering EDIT, the user should ensure that the 
file to be edited consists of no more than one logical 
record (refer to the PACK command for information on 
compressing files). If the file contains more than one 
logical record, all records but the first are lost. For 
additional informatiMi, refer to the Text Editor 
Reference Manual. 



ENQUIRE 



Normally, direct entry of information is possible only to the primary file. 

..._..,, ^^„, ^„.^„. cixiuAa iiic uocr Lu enter or moaiiy miormation in all 
files (mcluding the primary file). 

An important feature of Text Editor is its ability to reference direct access 
permanent files. Since a direct access file cannot be referenced with the 
OLD command, it cannot become the primary file, and direct entry of 
informatiOTi to the file is therefore impossible. Text Editor is one method 
that is used to accomplish direct entry of source code into a direct access 
rue. Text Editor commands are listed in appendix E. 

Requests the current job status. An important feature of this command is 
that It can be entered during job executiwi. lAF responds 



TERMINAL: 
SYSTEM: 
HLE NAME: 
STATUS: 



nnn.NAMIAF. 

Subsystem currently active 

Curroit primary file name 

IDLE 

or 
EXECUTE 



or 

WAIT 



No job being processed. 
User job being processed. 



MESSAGE: 



User job waiting for computer resources 

to become available. 
For execute or wait status, the message line contains 
the current job status message. For idle status, no 
message is printed. 



I 



nnn 



Terminal number. 



ENQUIRE,options 



Requests information about the system. The formats of the command are 
ENQUIRE,OP=piP2...pn,JN=ccc,0=lfni,FN=lfn2 



or 



ENQUlRE.pip2...pn 
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Command Description 



OP=pi Specifies any of the following options. More than one 

option can be specified (for example, ENQUIRE.BDF). 

Pi Description 
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A Causes all OP options except S and T to 

be executed (in the order B, D, R, U, J, 
L, F). 

B Requests user identification and job 

information (user number and index, job 
name and sequence number, family 
name, pack name, primary file name, 
subsystem, queue and CPU priorities, 
maximum and last assigned field 
lengths). 

D Requests resource demand information. 

Listing describes both resources (tape 
units and disk packs) demanded by job 
and resources currently assigned to the 
job. 

F Requests status of the user's local 

files. The information on each file is 
the same as that listed under the 
LENGTH command, described in this 
section. 

J Requests contents of control registers, 

error flag fields, and succeeding ecaitrol 
statements. 

L Requests loader information. 

R Requests amount of resources used 

(CPU time, mass storage activity, 
magnetic tape activity, permanent file 
activity, SRU adder constant value, 
total SRUs) in decimal. 

S Requests decimal number of SRUs 

used. The SRU is a unit of 
measurement which represents the total 
usage of the system by the user and 
includes CPU time, 1/0 activity, and 
memory usage. 

T Requests accumulated CPU time for 

this session in decimal. 

U Requests user's current limits on 

resource usage (seconds, job step SRUs, 
account block SRUs, dayfile messages, 
control statements, dispose files, mass 
storage) in decimal. 
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Command Description 



JN=ccc Requests the status of a batch job initiated with the 
SUBMIT command or from local batch. The JN 
parameter is the last three characters of the 
seven-character job identification name (jobname) 
the system assigns to the job when it is submitted. If 
the =cec is omitted, the status of each batch job in 
the system with the same user name as that of the 
terminal user is returned. The possible replies are 

jobname NOT FOUND, 
jobname IN INPUT QUEUE, 
jobname IN PRINT QUEUE, 
jobname IN PUNCH QUEUE, 
jobname IN ROLLOUT QUEUE, 
jobname EXECUTING. 

ii^Knoma TXT TPin^ 171"* V17VT7KrT "D/^T T r\TTT* r\JTCfrT? 

j-k^vmHAiiiw i4.'» X »i*i A^i^t ■»-* < J-ll.^ X ±^\JXJLJKf VI y^KJ iJKJ LUm 

The jobname NOT FOUND message usually indicates 
that the job has been processed and no longer exists 
in the system. However, this message may also be 
issued if the JN parameter is entered incorrectly. 

The jobname EXECUTING message indicates either 
that the job is executing or that it has been moved 
out for a higher priority job. Only the status of a job 
submitted under the current user name can be 
obtained. 

0=lfni Requests that output be placed on alternate file Ifni- 

If not specified, output is returned to the terminal. If 
0=lfni is the only parameter specified, the system 
prints option A on file Ifni- 

FN=lfn2 Requests the same information as the F option but 
only for the file name specified by Ifng. The file 
name must be a local file. If the file name is 
misspelled or is not currently associated with the 
user's job, the system responds 

FILE NOT FOUND. 

GOODBYE,application Same as BYE, application command. 

HELLO.appli cation If application is specified, this command is the same as the BYE,application 

command. 

If application is not specified, this command logs the current user out of 
lAF, as in the BYE command, but reinitiates the login sequence. Any 
temporary files that are to be retained must be made permanent before the 
HELLO command is entered. This form of the command allows a new user 
to log in without first having to establish communications with the network 
by dialing the computer site. 



t 
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Command Description 



HELP Allows the user to obtain assistance in the use of system commands. If the 

user at a terminal is not sure of the format of a command or its use, the 
HELP command provides an easily accessible on-line description of the 
system command set. lAF responds 

IF MORE INFORMATION NEEDED, TYPE YES. OTHERWISE, 
TYPE THE COMMAND NEEDED. 

9 

The user either types YES in reply to the request or enters the command he 
wishes to have described. A minimum of three characters must be entered 
if a command is typed. The user must type END after a question mark to 
terjninate the HELP command. 

LENGTH, Ifn Requests the file name, length, type, and last status of the local file 

^ecified by Ifn. If the Ifn parameter is omitted, the primary file is 
assumed. In this case, the primary file is sorted before the length is 
obtained, unless a NOSORT command precedes the LENGTH command 
(refer to description of NOSORT command in this section). 

lAF responds 

LOCAL HLE INFORMATION. 
FILENAME LENGTH/PRUS TYPE STATUS 
Ifn length type status 

Ifn Local file name. 

length File length in PRUs (each PRU contains 640 6-bit 

characters). 

type File type: 

IN. Input file. 

LL Library file. 

LO. Any local file that is neither the 

current primary file nor a direct access 
permanent file. 

PM. Direct access permanent file. 

PT. Primary file. 

SY. System file. 

An * following the file type indicates a locked file 
(user cannot write on a locked file). 
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Command 



LIBRARY 



LIMITS 



Description 



status 



File status: 



EOI File is positioned at end-of-information. 

EOF File is positioned at end-of-file. 

EOR File is positioned at end-of -record. 

I/C File is positioned somewhere between 

beginning- and end-of-information. 

Retrieves a copy of a permanent file from the catalog of special user name 
LIBRARY (refer to Library Command in section 5). 

Provides a listing of the user's current validation limits. Refer to LIMITS 



LIST.lnum.R, 
F=lfn 



Lists at the terminal the contents of the primary file unless the 
F parameter is specified. The primary file is automatically sorted before 
listing unless a NOSORT command precedes this command (refer to 
NOSORT command). 



Inum 



R 



F=lfn 



Specifies line number of the line where listing is to b^in. 
This parameter is optional and can be specified only if the 
primary file is being listed. The file should be sorted to 
obtain correct results. 

Specifies that end-of -record and end-of-file marks, if 
present, are to be indicated in the listing. This optional 
parameter can be specified only if listing the primary file. 
The primary file is listed from the beginning- to the 
end-of-information unless the Inum parameter is specified. 

Specifies listing of local file Ifn (optional). The file is not 
sorted before listing. When this parameter is specified, 
neither the Inum nor the R option can be supplied. The local 
file specified is listed from the current position to the 
end-of-information. 



lAF responds 

yy/mm/dd. hh.mm.ss. 

PROGRAM nnnnnnn 



header 



(program lines) 
READY. 
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^"""^"d Description 



I 



The header information printed is: 

yy/mm/dd. Current date. 

hh.min.ss. Current time. 

nnnnnnn File name. 

This header is not displayed under the batch subsystem. 

LNH Inum.R, Optional form of the UST command which lists the file without a 

r=an header. 

LOGIN.applicatiOT Same as HELLO.application command. 

LOGOUT,appHcation Same as BYE,application command. 

^^^ Allows the user to create a new primary file. lAF respwids 

FILE NAME: 

The user enters a valid file name. When lAF accepts the new file name, it 
replies 

READY. 

The file name specified becomes the new primary file and the previous 
primary file is released. All other current local files are released. 

NEW,lfn/ND Optional form of the NEW command which allows the user to specify NEW 

and the file name in one step. If the optional ND parameter is included 
the previous primary file is released, but no other local files are. 

NOSORT Prevents the system from automatically sorting the primary file by 

clearing an internal indicator called the sort flag. Sorting of the primary 
i?if,Jf initiated only if the sort flag is set when the LIST, LNH, RUN, RNH 
EDIT XEDIT. LENGTH, SAVE. REPLACE, or SUBMIT command is entered 
or when a procedure file caU is made. lAF responds 

READY. 

This command is generally used when making additions and/or modifi- 
catiCTis to the primary file. When followed by the NOSORT command the 
additions and/or modifications create a new logical record in the prim'ary 
file. The NOSORT command remains in effeel only until the next 
numbered Mm of source code is entered. This causes the sort flag to be 
turned on agai/i. Refer to FJie Sorting in section 3 for an example which 
Illustrates the effect of the NOSORT command. 
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Command 



OLD 



Deseription 

Allows the user to access a copy of a file that was previously saved in the 
permanent file system as an indirect access file and to make it the primarv 
file. lAF responds 



FILE NAME: 

The user then enters the selected file name, 
replies 



When the file is found, lAF 



OLD,lfn=pfn/ 
options 



PACK.lfni, 
Ifng.NR 



READY. 

A copy of the selected file becomes the new primary file; any subsystem 
associated with the file is selected automatically (refer to Temporary and 
Local Files in section 3 for an explanation of subsystem association). All 
local files are released following entry of this command. 

Optional fwrn of the OLD command which allows the user to specify 
the OLD command, the file name, and special options in one step. All local 
files are released following entry of this command unless the optional ND 
keyword is used. Refer to the command description in section 5 for 
information concerning this command format. 

Compresses several logical records of a local file into one 
logical record. When the operation is complete, lAF responds 

READY. 

The PACK command is entered in one of the four following formats, 
dep^ding upon the options selected. 



PACK 



PACK.lfn 



PACK.Ifnj, 
lfn2 



PACK.lfn], 
lfn2,NR 



Compresses the logical records of the primary file 
into one logical record. When the primary file is 
packed, it is not sorted automatically by subsequent 
operations that normally cause the file to be sorted 
(that is, LIST, RUN, and so on). Automatic sorting 
resumes when the user enters the next line of source 
code or the SORT command. 

Rewinds local file Ifn and compresses logical records 
of the file into one logical record. File Ifn is rewound 
again after the pack. 

Rewinds local file Ifnj, compresses logical 
records of the file into one logical record, and then 
writes the file to lfn2. If lfn2 currently exists, Ifni is 
written at the current position of lfn2. File lfn2 is 
rewound after the pack; Ifnj is not. 

Same as the preceding format, except that the 
no rewind (NR) parameter inhibits file Ifnj from 
being rewound before the pack, unless it is the 
primary file. 



The primary file is rewound after all operations. 
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Command 

PASSWOR.oldpswd, 
newpswd 



PRIMARY.lfn 



RECOVER.nnn 



RENAME,nlfni= 
olf n^ ,nlf n2= 
olfn2,..., 
nlfnn=olfnn 



RESEQ 



RETURN,lfni, 
lfn2,...,lfnn 

RETURN,* 



Description 

Allows validated users to change their password. The user must 
supply the correct current password (oldpswd) and an alphanumeric new 
password (newpswd). The maximum length for passwords is seven 
characters. The minimum length can be set by the installation to be from 
zero to seven characters; the released value is four. 

If the user wants secure entry of passwords, he can enter PASSWOR 
without parameters. lAF responds 

OLD PASSWORD: 
? BHHBQSBBB 

The user types the old password over the blacked-out characters and then 
presses® . The system then requests the new password in the same 
manner. (These blacked-out characters are provided only on hardcopy 
to-minals.) 

If any part of this command is in error* lAF replies 

ERROR IN PASSWOR ARGUMENTS. 
After the password has been changed, lAF replies 

READY. 

Makes the temporary file specified by Ifn the new primary file while 
releasing the previous primary file. (Direct access files cannot become 
primary files.) All other local files are retained. 

Enables the lAF user to resume processing after an accidental disconnect 
from the system or after a system malfunction that requires the login 
sequence to be reinitiated. Refer to Recovery in section 6 for a complete 
description and examples of the use of this command. 

Changes the name of temporary file olfnj to nlfnj. If file nlfn; 
currently exists, it is released. This command cannot be used to 
change the name of a permanent file. However, a temporary file 
(including a copy of an indirect access permanent file) can be renamed and 
then saved in the permanent file system under the new name. 

Enables the user to resequence or add line numbers to the current primary 
file. If the current primary file is a text file, line numbers can be added. 
Statements that reference line numbers are updated when BASIC programs 
are resequenced. Refer to Resequencing Line Numbers in section 6 for a 
complete description and examples of the use of this command. 

Releases local files !fni Ifnn. (When using tapes or packs refer to 

RESOURC control statement, NOS Reference Manual, volume 1.) 

Releases all local files including the primary file. All files to be retained 
must be made permanent before entering this command. (When using tapes 
or packs refer to RESOURC control statement, NOS Reference Manual, 
volume 1.) 
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command 

RETURN,*,lfni, 
lfn2 Iffifi 



REWIND.lfni, 
lfn2 Ifrin 

REWIND.* 



REWIND,*,lfni, 
lfn2,...,lfnn 

RNH 



RUN.options 



Description 

Releases all local files except lfni,...,lfnn. (When using 

tapes or packs refer to RESOURC control statement, NOS Reference 

Manual, volume 1.) 

Positions local files lfni,...,lfnn at beginning-of-information. 
Refer to File Structure in section 3 for additional information. 



Positions all local files at beginning-of-information. 
Structure in section 3 for additional information. 



Refer to File 



Positions all local files except Ifni Ifnn at beginning-of-information. 

Refer to File Structure in section 3 for additional information. 

Optional form of the RUN command which allows the user to run the job 
without a header being printed. The commands are identical in all other 
reaijeets. 

Compiles and/or initiates execution of the primary file or another local 
file. The primary file is sorted before being compiled unless a NOSORT 
command precedes this command (refer to description of NOSORT 
command in this section). lAF responds 



yy/mm/dd. 
PROGRAM 



hh.mm.ss. 
nnnnnnn 



header 



(data or error messages) 



SRU S.SSS UNTS. 

RUN COMPLETE. 

The header information printed is 

yy/mm/dd. Current date. 

hh.mm.ss. Current time. 

nnnnnnn File name. 

This header is not displayed under the batch subsystem. 

One or more of the followir^ options can be supplied with the RUN 
command. 



RUN,B=lfn 

or 
RUN,C=lfn 



Compiles the source program and generates 
binary file Ifn containing the resulting 
object code. The object code is not executed. 
File Ifn can later be executed under the execute 
subsystem by entering the RUN command. File 
Ifn can be retained as a permanent file using the 
SAVE (or REPLACE) command. 
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Command Description 

RUN,I=lfn Compiles and/or initiates execution of local file 

Ifn (Ifn is assumed to be sorted). In the execute 
subsystem, no compilation occurs. 

RUN,MA=nnnnn Uses nnnnn as the octal field ler^th for the 

current program execution.^ 

RUN,MI=nnnnn Increments the program's current field length by 

nnnnn octal.t 

RUN,T,qi,q2, This command applies only when running a 

•••.Qn previously compiled (object code) FORTRAN 

program in the execute subsystem. It allows the 
user to rename local files specified in the 
PROGRAM statement without recompiling the 
program. Parameters qj through q^ specify new 
local file names to be used in place of those that 
currently exist in the PROGRAM statement (the 
parameters are order dependent and must 
correspond to those they replace). 

The following example illustrates the use of the RUN.T command. Assume 
a FORTRAN program contains the following PROGRAM statement. 

PROGRAM TEST (INPUT,OUTPUT,AAA,BBB,TAPEl=AAA, 
TAPE2=BBB) 

Normally, to execute a program containing this statement, the user must 
define local file AAA. Local file BBB results from the execution of the 
program. However, the user could change the names of local files AAA and 
BBB without recompiling the pr^ram (if the object program exists) by 
using the RUN,T command under the execute subsystem. For example: 

RUN,T,INPUT,OUTPUT,CCC,DDD 

SETASL.nnnnn Sets SRU account block limit; allows the user to specify an SRU limit 

(nnnnn decimal unitstt ) for all operations prior to lAF logout or entry of 
another CHARGE command. The maximum depends on the user's 
validation limits and the validation limit associated with his charge number 
(refer to LIMITS Command at the end of this section). If nnnnn is larger 
than the maximum value, the system uses the maximum value allowed for 
the user. The user can enter 

SETASL,* 

to set the SRU limit at its maximum. 



+ K the user e?iocc><1s the field length for which he is validated, the message ILLEGAL USER ACCESS 
US returned t< the terminaL 
t tTo enlcr octal units, use nnnnnB, whero nnnni' i;; ■)ii octal number. 
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Command 
SETJSL.nnnnn 



Description 

Sets SRU job step limit; allows the user to specify an SRU limit (nnnnn 
decimal unitsT) for each subsequent individual operation (job step). The 
maximum value of nnnnn is the same as for SETASL, except nnnnn cannot 
exceed the current value of the account block SRU limit. If nnnnn is larger 
than the maximum value, the system uses the maximum value allowed for 
the user. The user can enter 



SETTL, nnnnn 



SETJSL,* 

to set the SRU job step limit at its maximum. If a job exceeds its SRU 
limit, the system issues the SRU limit message. To continue job execution, 
the user must enter the S command (refer to Job Suspension in section 6). 

Sets time limit; allows the user to ^ecify a time limit (nnnnn decimal 
seconds) for each subsequent job step requiring the central processor. The 
— A.. ...... c...,^, „,„.t vj^;(^ciiua uyuii me users vaiiaation nmits prefer to 

LIMITS Command at the end of this section). If nnnnn is larger than the 
maximum value, the system uses the maximum value allowed for the user 
The user can enter 



SETTL,* 



SORT 



SORT,lfn,NC=n 



to set the time limit at its maximum. If a job step exceeds its time limit, 
the system issues the time limit message. To continue job execution, the' 
user must enter the T command (refer to Job Suspension in section 6). 

This command is useful when debugging a program thai is cycling in a loop. 

Sets an internal indicator called the sort flag. Sorting of the primary file 
takes place when the next LIST, LNH, RUN, RNH, EDIT, XEDIT, LENGTH 
SAVE, REPLACE, or SUBMIT command is entered. The lines of the 
primary file are then arranged in order using the first five digits of the Une 
number, and the logical records of the file are compressed into one logical 
record. ^ 

Sorts local file Ifn by arranging the statements in order using the first n 
digits of the line number (where l<n<10). If the NC option is omitted the 
sort is performed using the first five digits of the line number. The logical 
records of file Ifn are also compressed into one lexical record when the sort 
is performed. When the sort is complete, file Ifn is positioned at 
end-of-informatiOT unless it is the primary file, which is automatically 
rewound. This command forces immediate sorting of the specified file and 
is commonly used to sort the primary file when it is too long to be sorted 
automatically by the system. Refer to the description of File Sorting in 
section 3 for additional information. 



tTo enter octal units, use nnnnriB, where nnnnn is nn octal number. 
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Com mand Description 



STATUS Same as the ENQUIRE command. 

SUBMIT Allows a validated user to create a batch job deck image and submit it to 

the local batch queue as a deferred batch job. The user cannot interact 
with a job submitted for processing using this command. Rather, the job is 
treated in the same manner as a job submitted from the card reader at the 
local computer site or from a remote batch terminal. Refer to section 7 
fOT a complete description and examples of the use of this command. It is 
recommended that the user become familiar with all information in section 
7 before attempting remote job submittal. 

SUMMARY Same as the ENQUIRE command, except default for SUMMARY lists the 

resources used during the sesion rather than current job status (refer to 
description of ENQUIRE command in this section). 

TEXT Selects text mode. This command allows direct entry of information 

(program statements, data, or text) into the primary file without specifying 
line numbers. Commands entered in text mode are interpreted as text and 
are not processed by the system. lAF responds 

ENTER TEXT MODE. 

The input line may consist of a maximum of 150 6-bit characters. Data is 
added to the end of the file. 

To terminate text mode, the user should enter the interruption sequence or 
the to-mination sequence defined for the terminal in use or the ETX 
character followed by @ . I AF responds 

EXIT TEXT MODE. 

Since a text file does not normally contain line numbers and therefore 
cannot be sorted (and packed) automatically by the system, a PACK 
command should be issued after exit from text mode to ensure that the 
data is in one logical record. 

The following example uses text mode to create a CCL procedure file 
which accesses a list of grades, runs a FORTRAN program using the grades 
as input, and saves the output. A FORTRAN program is used to calculate 
the grade average, highest grade, and lowest grade from periodic input by 
classroom instructors. It is created in the following manner. 
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Command Description 

new, exam 



READY, 
text 
ENTER TEXT MODE. 



program examdnput .output .result , tape 1=result) 

dimension i{150) 

imin=100 

imax=0 

itotalrO 

read(l,10)(i(j),j=1,30) 
10 format(14{i3.1x)) 

do 20 j=1,30 

itotal=itotal+i( j) 

if (i(j) .It. iraax) go to 15 

iraax=i{j) 
15 if (imin .gt. i(j)) irain=i(j) 
20 continue 

avg=itotal/30 

print 30, avg 
30 formate 17h grade average = ,f5.2) 

print 40, imin 
10 formate I6h lowest grade = ,i3) 

print 50, imax 

50 formate 17h highest grade = ,i3) 
end 



To exit text mode, the user enters either the interruption sequence or the 
termination sequence. The system responds 

EXIT TEXT MODE. 

The user should then enter the PACK command; this ensures that the file is 
one logical record. 

pack 

READY. 
This program is then made into an indirect access permanent file, 
save 

READY. 
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Command Description 

To correlate this program with input data, a procedure file is created under 
text mode according to the following: 

new, grades 

READY, 
text 
ENTER TEXT MODE. 

•proc, average. 

getCexam, result) 

rewind(result) 

ftn(i=exam,l=list) 

Igo. 

exit. 

replace(list) 



The user then exits from text mode using the interruption sequence or the 
termination sequence. 

EXIT TEXT MODE, 
pack 



READY. 

This file is then made into an indirect access permanent file with the name 
GRADES. 

save 



READY. 

The following data is entered under text mode as a file called RESULT. All 
other files are released. 

new, result 



READY, 
text 

ENTER TEXT MODE. 

5^* 87 90 63 51 87 88 92 73 76 76 81 83 67 
78 55 97 68 82 84 9M 79 88 77 66 78 98 67 
87 99 
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Command 



Description 
Exit is made from text mode and the file is packed into one logical record. 



USER.usernam 



XEDIT.options 



EXIT TEXT MODE. 
pack 



READY. 
This data file is made into an indirect access permanent file, 
save 

READY. 
To make use of the procedure file, the user enters 

begin , average .grades 



This gives the printout: 

GRADE AVERAGE = 79.00 

LOWEST GRADE = 51 

HIGHEST GRADE = 99 



Returns the number of the terminal at which the user specified by usernam 
is currently logged in. When several terminals are logged in under the same 
user name, a list of terminal numbers is returned. The USER command can 
be entered only from the access subsystem. It is used in conjunction with 
the DIAL command to send a mess^e to a user at an interactive terminaL 

Selects XEDIT. 

The command format is 

XEDIT,lfni,pi,p2 Pn-des 

If Ifni is specified, it must be the first parameter listed; if omitted, the 
separators which would precede and follow Ifnj must be included. The 
delimited command sequence (dcs), if used, must follow the period. All 
other parameters are order independent. A brief description of the XEDIT 
parameters follows. 

Ifnj Name of the local or permanent file to be edited. If Ifni is 

omitted, the primary file is edited. 

Pi One or more of the following parameters. 
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AS Processes the file in ASCII mode. Upon 

exiting XEDIT, the terminal is returned to 
the mode in effect before the editing 
session. If the user omits the AS parameter, 
the mode that the terminal is m before he 
enters the XEDIT command remains in 
effect. 

B Processes the job as a batch origin job. 

C Creates a new file Ifni (creation mode). 

FR Takes the first editing commands from the 

first line of file Ifni- If IFR and I 
parameters are both specified, XEDIT 
executes FR and then I. 

I=lfn2 Tal<es editing commands from file lfn2. If 

1=0, commands are taken from the dcs field. 
If I is omitted, commands are taken from 
file INPUT. 

L=lfn3 Places XEDIT output on file Ifns. If L=0, no 

output is generated. If L is omitted, file 
OUTPUT is assumed. 

NH Suppresses printing of the XEDIT header. 

P Retrieves and edits permanent file Ifn] . 

Direct access files are attached in write 
mode. If P is omitted, the file Ifni '^ 
assumed to be a local file. 

dcs Delimited command sequence that is processed before XEDIT 

takes commands from file INPUT or file lfn2. 

XEDIT commands are listed in appendix E. For a complete description of 
the XEDIT parameters and commands, refer to the XEDIT Reference 
Manual. 

-pname.pfile.pi, Optional form of the BEGIN command. Refer to the description of 

P2'— 'Pn the BEGIN command in this section for more information. 
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LIMITS COMMAND 

Entry of the LIMITS command provides a list of the user's validation limits. Validation Umits are the 
internal system controls associated with each user name which govern use of certain system resources. 
All hmits are set by the site when the user registers. The listing provided describes both the resources 
available to the user and the extent to which they may be used. All numeric values listed are decimal 
unless the postradix B appears, signifying an octal value. The following information is listed. 

^^^^^ Description 

^'^^ Maximum number of magnetic tapes the user is allowed to have assigned to 

his job concurrently. 

^^ Maximum number of auxiliary devices the user is allowed to have assigned 

to his job concurrently. 

"^^ Maximum amount^of central processor time in seconds allowed for the 

user's job step vrefer to SETTL command). 

^^^ Maximum number of central memory words the user is allowed to request. 

This is the job's maximum field length, expressed as multiples of lOOo 
words. ° 

^^ Maximum number of files the user is allowed to have associated with his 

job concurrently. 

^^ Maximum number of deferred batch jobs the user is allowed to have in the 

system concurrently (refer to description of SUBMIT command in section 7). 

^^ Maximum number of permanent files the user is allowed to have in each 

catalog. This limit applies for each catalc^ being accessed (main, public 
auxiliary, or private auxiliary catalogs). 

^^ Maximum number of PRUs available to the user for indirect access 

permanent files. 

^^ Maximum number of PRUs available to the user for any given indirect 

access permanent file. 

TC = xxxxx Initial character set to be used by the terminal. For each user name xxxxx 

is one of the following: 

STANDARD ASCII graphic 63- or 64-character set. 

ASCn ASCII 128-character set. 

IS = xxxxx Initial subsystem for the terminal. For each user name, xxxxx is one of the 

following: 

BASIC BASIC subsystem. 

BATCH Batch subsystem. 



I 



tFor further information about this field, refer to the NOS Reference Manual, volume 1. 
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Field Description 



MS 



EXECUTE Execute subsystem. 

FORTRAN FORTRAN subsystem. 

FTNTS FTNTS subsystem. 

NULL Null subsystem. 

Maximum number of mass storage PRUs the user is allowed to additionally 
allocate to his job. 



DF Maximum number of dayfile message requests the user is allowed to issue 

to the system and/or job day files. 

CC Maximum number of batch control statements processed for a user 

(excludes time-sharing processed cwitrol statements). 

OF Maximum number of job print and punch files the user Is allowed to dispose 

to the output queues. 

*^F Maximum number of cards that can be punched from a user's disposed 

punch file. 

^P Maximum number of lines that can be printed from a user's disposed print 

file. 

FC Maximum number of extended core storage (ECS) memory words that the 

user is allowed to request. 

SL Maximum number of SRUs allowed for the user's job (refer to SETASL and 

SETJSL commands). 

^^ Not currently used by the system, but is provided for future expansion of 

validation control. 

FN Project number to which the user is aligned (not the project number 

associated with the charge number entered at l(^in with the CHARGE 
command). 

^^ Maximum number of PRUs available to the user for any given direct access 

pCTmanent file. 

^^^ Access word; the octal value listed corresponds to the following access 

options (bit is option 0, bit 1 is option 1, and so forth). 

Option Signifies 



User can ohoiige his password (refer to PASSWOR 
command). 

User can use the acc-es;-; subsystem (refer to the ACCESS 
command). 

User can f-reate direct access permanent files. 
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^'^^'^ Description 

Option Signifies 

3 User can create indirect access permanent files. 

4 User can have system origin status from anyjob origin if 
the system console is in debug mode (refer to NOS 
Reference Manual, volume 1). 

5 User can create and access library type files (refer to 
NOS Reference Manual, volume 1). 

6 User can assign nonallocatable devices (magnetic tape 
units ) (refer to NOS Reference Manual, volume 1). 

7 User can access system without supplying his assigned 
charee and project numbers. 

8 User can create and/or replace files on auxiliary devices. 

9 User can access special transaction functions (refer to 
TAF Reference Manual). 

10 User's terminal is designated as a no-timeout terminal. 
If this bit is not set, the terminal automatically logs off 
after 10 minutes of inactivity. With this bit set, the 
terminal remains connected until the user logs out. The 
TIMEOUT command (refer to Terminal Control 
Commands in this section) clears this bit for the session 
in progress. 

11 User can use the system control point (SCP) facility. 

12 User has special accounting privileges. 

13 User has special privileges for batch jobs. 

14 User can use PROTECT statements. 

24 User can access lAF. 

25 User can access RBF. 

26 User can access TAF. 

27 User can access Message Control System (MCS). 

28 User can access Terminal Verification Facility (TVF). 

Bits 29 through 47 may also be set to indicate that the user is validated to 
access additional applications. 

For example, if the access word listed is 

AW=00000000000300000215 
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the user is validated for options 0, 2, 3, and 7 and can access lAF and RBF 
(options 24 and 25), as shown in the following: 

Options ... 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 




AW= ... 3 

If any parameters are included with the LIMITS command, lAF responds 

ERROR IN LIMITS ARGUMENTS. 
Following is a listing produced by the LIMITS command. 

ILIMITS. 

79/07/25. 07.53.51. PAGE 



JLC2016 


2016 


ABt = , 




ABt = , 




ABt = , 




ABt = : 




HT = 


3, 


RP = 


2, 


TL = 


UNLIMITED, 


CM = 


2037B, 


' NF = 


56, 


DB = 


8, 



PC = UNLIMITED, 
OS = 11096, 
PS = 6U, 

pa;= even , 

ROjr system, 
PXT= HALF , 
TT'= TTY 
TO = STANDARD ' 
IS = NULL , 
MS = 66048, 
DP = 1008, 
CC = UNLIMITED, 
OP = 12, 
CP = UNLIMITED, 
LP = UNLIMITED, 
EC = OB, 
SL = UNLIMITED, 

CN =, 

PN = 
DS = 1024, 

AH = 000C0000002700000555 



t These '^(^Ids do not apply to network terminals bui arc retained for compatibility with a previous 
timc-shnring system. Tlteir settings have no meaniiij; tor an lAF user. 
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PERMANENT FILE COMMANDS 



GENERAL DESCRIPTION 

All lAF users can access permanent files after the login procedure to lAF is complete. Validated users 
can also create permanent files (refer to LIMITS Com mand at the end of section 4 for information 
concerning user validation limits). imormauon 

The user name supplied during login represents a specific catalog in the permanent file system. The 
catalog contams a list of files saved under that user name as well as pertinent information about each 
file. All permanent file requests are made to this catalog unless an alternate user name or an auxiliary 
device is specified in the file request. An auxiliary device is a mass storage permanent file device used 
to supplement the normal permanent file devices associnteri with tho c,Tcf^r„ ff^^n,, ^„,.:,-.„\ ,^ .1 
?lif I!^*^.M^'' ™i"^ '^ specified, the request is made to that user's catarog!" If I validTtVdr^r 'specifies 
that the file resides on an auxihary device, the request is made to a separate catalog on that device A 
separate catalog exists on the auxiliary device for each user with files on that device. A user can obtain 
information about the files m his catalog, and in the catalogs of alternate users he can access, by 
entermg the CATLIST command (refer to CATLIST Command in this section). 

User names that contain asterisks (•) represent users with automatic read-only permission to files in 
eatalop of other users. The user name must match the alternate user name in all characters that are 
not asterisks. For example, a user with the user name *AB*DE* can access all files in the catalogs of 
the following users: UABCDEF. UABDDEE, MABCDEl, MAB1DE3. caiaiogs oi 

All permanent files are classified according to the manner in which they are accessed: indirect access or 
direct access. The mode of access is determined by the command used to create the file. Indirect 
access Pf^a^fntfiles are created with the SAVE or REPLACE command; direct access permanent files 
tZ oommf Jth r^ °f™E command. The command used to create a permanent file also determines 
the command that must be used to access the file. The user must enter the OLD. LIBRARY or GET 
command m requests for indirect access files. The ATTACH command must be entered to request use of 
a direct access file. The following are the characteristics of each type of file. 

Indirect Access An indirect access file is. as the name implies, a permanent file that cannot 

be accessed directly by the user. Instead, when access is requested through 
entry of the OLD. LIBRARY, or GET command, a copy of the permanent file 
IS created. The copy, considered a temporary file, is referenced instead of 
the permanent file in aU subsequent I/O operations. This feature offers 
protection against endangering the integrity of the permanent file. Several 
copies of an indirect access file can exist in the system at the same time If 
the temporary file is altered, the user must enter the REPLACE command to 
update the permanent file. If the user is not allowed to update the permanent 
file, he can create a new indirect access file, reflecting his modifications, by 
entering the SAVE command and specifying a new file name. 

Indirect access permanent files are allocated in blocks of 64 central memory 
words (one physical record unit). This block size is relatively small compared 
to the block size of direct access files (refer to appendix D). Thus 
permanent files that are smaU in size are typically indirect access'files. This 
IS done to avoid allocation of more mass storage area than is actually 
required for the file. ^ 
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Direct Access A direct access file is a permanent file which, upon request, becomes linked 

directly to the user's job. Unlike indirect access files, a copy of the 
permanent file is not created for user access. Use of a direct access file is 
requested by entering the ATTACH command, and all subsequent I/O 
operations are perfwrned on the permanent file itself. Although a copy of 
the permanent file is not created, a local file name may be specified in the 
request fw a direct access file. This allows the user to reference the file by 
a name other than its permanent file name. Because data is written directly 
on the permanent file rather than on a copy, care must be taken when 
modifying a direct access file. 

Direct access files have a write interlock feature; that is, if a user has 
attached the file in write mode, it cannot be attached by another user. 
Similarly, a user cannot attach the file in write mode until all users currently 
accessing the file in alternate modes have released it. 

Direct access permanent files are allocated in large blocks (refer to appendix 
D) and are generally used as large data base files. When a user creates a 
direct access file, it is placed on the device with the most space available, 
unless a specific device type is specified in the request. If more than one 
device of the type specified exists, the file is placed on the device with the 
most space available. 

In summary, the file access mode depends on the command used to create the file. Direct access files 
are created with the DEFINE command. Indirect access files are created with the SAVE or REPLACE 
command. A permanent file cannot be requested as a direct access file one time using the ATTACH 
command and as an indirect access file later using the OLD, LIBRARY, or GET command. The command 
that must be used to access the file depends upon the command that was originally used to create the 
permanent file. 



PERMANENT FILE COMMAND FORMAT 

The following is the general format of a permanent file request. The optional keywords (kw) and 
corresponding options must follow the specified file name and the slash character; they are order 
independent. 

pfcmd,lfn=pfn/kwi=optiOTi,...,kwn=optionn 

pfcmd Permanent file command name. 

Ifn Local file name used when creating or accessing permanent file pfn. 

pfn Name under which the file is cataloged in the permanent file directory. If the pfn 

parameter is omitted, Ifn is assumed to be the permanent file name. 

The following are the keywords and corresponding options which can be included. 

^^ option Description 

UN= usernam Alternate user name. This parameter is necessary only if the 

permanent file involved resides in another user's catalog. To 
access a file in jinother user's catalog, the requesting user must 
have explicil permission (refer to PERMIT command in this 
section), must have automatic read-only permission (user name 
contains asterisks for all characters that do not match in the 
alternate user name), or the file must be semiprivate or public. 
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jew option 

PW= passwrd 



CT= n 



PRIVATE 



S OR SPRIV 



PU or PUBLIC 

M= m 

W or WRITE 

M or MODIFY 

A or APPEND 

R or READ 

RM or READMD 



Description 

One- to seven-character password for a file. If specified by file 
originator, this password must then be given whenever alternate 
users access the file. 

For secure entry of the password, the user should specify PW 
without entering the password in the command. lAF responds with 

PASSWORD: 
? BHHBSB^ 

The user types the password over this blacked-out area. 

Permanent file category. The file category determines which users 
can access a file. There are three categories of permanent files. 

Private nie. Files available for access only by the 
originating user, by those explicitly granted permission (refer to 
PERMIT command in this section), or by those with automatic 
read-only permission. 

Semiprivate file. Files available for access by any user knowing 
the file name, password, and user name and whose permitted mode 
of access is not NULL (refer to description of permission mode 
under keyword M). Accesses by alternate users are recorded for 
the originator of the file. This includes the user name of the 
alternate user, the number of accesses made, and the date and time 
of the last access (refer to CATLIST Command in this section). 

Public file. Files available for access by all users knowing the file 
name, password, and user name. Only the total number of accuses 
are recorded for the originator of the file. 

File or user permission mode. 

Write mode. Allows the user to write, modify, append, read, 
execute, or purge the file (modify permission applies only to direct 
access files). 

Modify mode. Allows user to modify information within a direct 
access file and/or append information at the end of the file. The 
user can also read or execute the file. This mode applies only to 
direct access files. 

Append mode. Allows user to append information at the end of the 
file. 

Read mode. Allows user to read and/or execute the file. 

Read modify mode. Allows user to read a direct access file with 
the implication that another user may currently be accessing the 
file in modify mode. The file can also be executed in this mode. 
This mode does not apply to indirect access files. 
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kw optJCTi Description 

RA or READAP Read append mode. Allows user to read a direct access file with 

the implication that another user may currently be accessing the 
file in append mode. The file can also be executed in this mode. 
This mode does not apply to indirect access files. 

E or EXECUTE Execute mode. Allows the user to execute the file. 

N or NULL Null mode. Removes previously granted permission. 

SS= subsyst Subsystem to be associated with a file. This keyword can be 

specified on only the SAVE and CHANGE commands. If the user 
specifies just SS, the current subsystem is associated with the file. 
If SS=subsyst is omitted when saving or changing a prim^Fy file, the 
current subsystem is associated with the file. If omitted when 
saving or changing a nonprimary file, the null subsystem is 
associated with the file. 



I 
I 



subsyst 


Description 


BASIC 


BASIC subsystem 


BATCH 


Batch subsystem 


EXECUTE 


Execute subsystem 


FORTRAN 


FORTRAN subsystem 


FTNTS 


FTNTS subsystem 


NULL 


Nun subsystem 



The user can enter the first three characters of the subsystem 
name as an abbreviation for the subsystem. 

Type of device on which the permanent file resides or is to reside; r 
can be tuiy of the following. 

r Device 



DE Extended core storage 

Din 844-21 disk storage subsystem (half track; l<n<8) 

DJn 844-4X disk storage subsystem (half track; l<n<8) 

DKn 844-21 disk storage subsystem (full track; l<n<8) 

DLn 844-4X disk storage subsystem (full track; l<n<8) 

DMn 885 disk storage subsystem (half track; l<n<3) 

DP Distributive data path 

DQn 885 disk storage subsystem (full track; l<n<3) 

n indicates number of units. 
X is 1 or 4. 
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kw 



option 



S= space 



PN= packnam 



Description 
The R keyword can be used in two ways. 

• It can be specified on the DEFINE command to indicate 
the type of family device on which the direct access file 
is to reside. The user should consult his site to determine 
which devices are available. Appendix D contains a list of 
the block sizes allocated for each device type. If the file 
already exists on another device, R is ignored. If an 
illegal device is specified, the system responds 

DIRECT ACCESS DEVICE ERROR. 

If the number of units specified does not agree with the 
actual number for device types DI, DJ, DK, DL, DM, or 
DQ, the system issues the message 

ILLEGAL DEVICE REQUEST. 

• It can be used in conjunction with the PN and NA 
keywords on any permanent file command (including 
DEFINE) to identify an auxiliary device on which the file 
resides or is to reside. If PN and NA are specified but R 
is not, the system default device type is assumed. If the 
device type of the auxiliary device PN conflicts with the 
device specified by the R parameter, the system issues 
the message 

ILLEGAL DEVICE REQUEST. 

For example, if auxiliary device PN has device type DI 
and the device type specified by R is DK, a conflict exists 
and the error message is issued. 

Amount (in decimal PRUs) of space wanted for a new direct access 
permanent file (refer to DEFINE command). There are 640, 
decimal, 6-bit characters in a PRU. The system then creates the 
file on a device with the specified amount of space available. 
Unused space is not guaranteed to be available if the user attempts 
to expand the file at a later date. If no device currently has the 
specified amount of space available, the system responds 

PRUS REQUESTED UNAVAILABLE. 

If S is used in conjunction with the R keyword, only devices of the 
type specified are checked for adequate space. 

One- to seven-character pack name used in conjunction with the R 
keyword to identify an auxiliary device to be accessed in the 
permanent file request. This parameter is specified only when the 
file to be accessed resides on an auxiliary device. If the device is 
currently not available and the NA keyword is not specified in the 
request, the system responds 

DEVICE UNAVAILABLE. 

An auxiliary device is not necessarily a disk pack that can be 
physically removed as the parameter name implies. Rather, an 
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kvi_ option Description 

auxiliary device can be any mass storage device supported by the 
system and defined as such by the site. Auxiliary devices are used 
to supplement the normal mass storage permanent file devices 
associated with the system (family devices). If two or more 
auxiliary devices are to be in use concurrently, the user must enter 
the batch subsystem and issue the RESOURC control statement 
(refer to the NOS Reference Manual, volume 1, for information 
concerning the RESOURC statement). The user must be validated 
to create or replace files on an auxiliary device. 

NA No abort. TTie NA keyword specifies that if a requested resource is 

not available, the command is not aborted. NA can be used as 
follows; 

• It can be specified on the ATTACH command to indicate 
that the user wants to wait for the direct access file to 
become available. If the file is currently being accessed 
in a mode that conflicts with that specified in the 
command (interlocked), the user's job is suspended and 
subsequent terminal entry is not accepted. To terminate 
the request, enter the termination sequence. 

• It can be used to prevent a permanent file command from 
aborting if a specified file does not exist or if the user 
does not have permission to access the file. For the 
time-sharing user, this is useful for procedure files which 
perform their own error processing. 

• It can be used in conjunction with the PN and R keywords 
on any permanent file request (including the ATTACH 
command) for a file that resides on an auxiliary device. If 
the device is not currently available, the NA keyword 
directs the system to make the desired auxiliary device 
available. The system does not make the device available 
unless the user is validated to have at least one auxiliary 
device assigned to his job. 

Use of the NA keyword prevents the job step from aborting when 
errors occur. If the user is in the batch subsystem, the dayfile 
message indicating that an error occurred is returned to the 
terminal even though the job step does not abort. However, in any 
other subsystem, no indication of an error is given. To ensure that 
a command with the NA parameter has been processed without 
error, the user should use the DAYFILE or ENQUIRE, F command. 

NIJ No drop. The use of the keyword ND in an OLD, NEW, or 

LIBRARY command prevents local files from being released. 

•^^ Clear error flag. The use of the keyword CE in the CHANGE 

command cle«rs the error flag which had previously been set. 
(Refer to the NOS Reference Manual, volume 1, for more 
information on file error status.) 
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PERMANENT FILE PROCESSING COMMANDS 

The following permanent file commands are available to the user. The parameters specified have been 
described in Permanent File Command Format in the preceding pages. 



Com mand 

APPEND.pfn.lfni Ifnn/ 

UN=usemam,PW=passwrd, 
PN=packnam,R=r,NA 



ATTACH,lfni=pfni,lfn2= 
pfn2,...,lfnn=pfnn/ 
UN=usernam,PW=passwrd,M=m, 
PN=packnam,R=r,NA 



Description 

Appends temporary files lfni,...,lfnn at the end of 
the specified indirect access permanent file pfn. The 
logical structure of the files is retained; that is, EORs and 
EOFs are appended as well as data. Each temporary file is 
appended in the order specified in the command. This 
command can only be used for indirect access permanent files. 

Establishes a link to permanent file pfn, for direct 
access usage. If pfnj is omitted, the system assumes 
lfnj=pfnj. 

A temporary file is not created since user access is directly to 
the permanent file. The Ifnj parameter is used to reference 
the attached file by a name other than its permanent file name 
(pfnj). If Ifnj specifies the name of a temporary file, the 
contents of that file are lost when the permanent file is 
attached. If Ifn; specifies the name of a direct access 
permanent file that is already attached, that file is released, 
and the file being attached is referred to by the name Ifnj. frj 
addition, Ifnj cannot specify the primary file name. A direct 
access file cannot become the primary file. 

If the M keyword (permission mode) is omitted, the system 
assumes read permission for the attached file. The M keyword 
must be specified by all users, including the file originator, if 
the file is to be modified or if new information is to be added. 

If the NA keyword is not specified and another user is cur- 
rently accessing the file in a mode that conflicts with that 
specified in the command (M keyword), the system responds 

Ifn BUSY. 

When a direct access permanent file is attached in the write 
mode, it should be released after use so that it can be attached 
by other users. When a direct access permanent file is 
attached in the write mode, the last modification date is 
incremented even if the file is not altered. 
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Command 



Description 



CHANGE,nfn=ofn/PW=passwrd, 
CT=n,M =m ,SS=subsyst ,PN= 
packnam,R=r,NA,CE 



A direct access permanent file can be released with any of the 
following commands (refer to section 4 for a description of 
these commands). 

• OLD, NEW, or UBRARY (all local files also released). 

• GOODBYE, BYE, LOGOUT, HELLO, or LOGIN (all 
local files also released). 

• CLEAR or CLEAR,* (all local files also released). 

• RETURN, Ifn (local file specified released) or 
RETURN,* (all local files also released). 

A direct access file is also released if the Ifn parameter on 
subsequent GET or ATTACH commands specifies the name of 
the attached file. 

Allows the originator of a direct or indirect access 
permanent file to alter any of several parameters with- 
out having to attach and redefine the file or retrieve and save 
it. This command is valid only for the originator of the file 
(UN parameter is illegal). 

The nfn parameter specifies the new permanent file name to 
be assigned; ofn is the current file name. If no name change is 
desired, only ofn is specified. To clear the password currently 
assigned to a file, set the new password equal to zero (PW=0). 
The CT, M, PW, and SS keywords should be specified only for a 
change in the parameter associated with that keyword. Ttie 
PN and R keywords cannot be used to specify a new auxiliary 
device. They are used only to specify a new auxiliary device 
on which ofn resides. The use of the CE keyword clears the 
file error status and allows the change in parameters to be 
made. 

If the current permanent file name, ofn, is not in the user's 
catalog, the system responds 

ofn NOT FOUND. 

If the new permanent file name, nfn, already exists in the 
user's catalog, the system responds 

nfn ALREADY PERMANENT. 
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Command p,„„ . ^. 

Description 



To IfT-^fn') ^^^ ^"^'^^ « validated user to create a direct access perma- 

Pwipa^wrTcT^^^^ M-m R-r T' •'"' ^P^"^^ «"' ^"^^'^ " '" ^"^e mode ff ' ' 

If pfni is specified, the Ifnj parameter can be used in two ways. 

• To reference the direct access file by a name other 
than Its permanent file name (pfnj). In this case, the 
direct access file created contains no information 
initially. Data is placed on the file in succeedine 
write operations. ^ 

• To define a temporary file as a direct access 
permanent file. The temporary file specified must 
reside on a mass storage device that also supports the 
residence nf Hiro/»t onnaoc .%„_ ^ ^ »!. .» .. 

specified by Ifnj does not reside on such a device, the 
system responds 

DIRECT ACCESS DEVICE ERROR. 



NOTE 



Since lAF users are generally unaware of 
the type of device that contains their 
temporary files, this use of the Ifnj 
parameter is not recommended. 



If the optional keywords are omitted, the system assumes the 
foUowing parameters. aoaumeb me 

PW None. 

CT Private file. 

M Write mode. 



R 
S 



I File placed on device with most space 
I available. 



PN None. 

NA Not applicable unless PN specified. 

If the user releases the file and then wants to access it at 
some time in the future, the ATTACH command must be 
entered (refer to the ATTACH command in this section)! 

For information regarding creation of indirect access 
permanent files, refer to the SAVE command in tWs section. 
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Command 



Description 



GET,lfni=pfni,lfn2= 

Pfn2 lfnn=pfnn/ 

UN=usemam,PW=passwrd, 
PN=paeknam,R=r,NA 



UBRARY,lfn=pfn/PW=passwrd, 
PN=packnam,R=r,NA,ND 



OLD,lfn=pfn/UN=usernam, 
PW=passwrd,PN=packnam,R=r, 

NA.ND 



Retrieves a copy of the specified indirect access perma- 
nent file (pfnj) for use as a temporary file (Ifnj). 
This command can only be used for indirect access perma- 
nent files. If pfnj is omitted, the system assumes lfnj=pfnj. 

To reference the temporary file by a name other than its 
permanent file name (pfnj), the Ifnj parameter is specified. 
However, if Ifnj specifies the name of a current local file, the 
contents of that file are replaced by the copy of pfnj. The 
current primary file and subsystem remain the same, unless 
the file name specified for Ifnj is that of the current primary 
file. &i this case, the contents of the primary file are replaced 
by the copy of pfnj, which becomes the new primary file. 
Furthermore, if pfnj has a subsystent fl^ assoeiated with it 
(refer to SAVE command in this section), that subsystem is 
selected automatically. For example, if file A is the current 
primary file and the user enters 

GET,A=B 

the copy of permanent file B becomes the new primary file. If 
a subsystem other than the one currently active is associated 
with file B, it is selected. 

In order for the user to access a file in another user's catalog 
(UN parameter specified), the permission mode must allow the 
user to read the file. 

Retrieves a copy of the specified indirect access perma- 
nent file from the catalog of special user name LIBRARY and 
makes it the primary file. 

The permission mode is that which has been granted for 
private files or specified in the catalog for semiprivate and 
public files. All local files are released unless the ND keyword 
is specified. 

The ATTACH, GET, or OLD command can also be used to 
access permanent files in the catalog of user number 
LIBRARY. For additional information, refer to LIBRARY 
Command at the end of this section. 

Retrieves a copy of the specified indirect access perma- 
nent file for use as the primary file. If a specific 
subsystem is associated with the file, it is selected 
automatically. Refer to the description of the SAVE command 
in this section for additional information on subsystem 
association. All local files are released unless the ND keyword 
is specified. 
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Command 



Description 



PACKNAM,PN=packnam 

or 
PACKNAM.packnam 



Enables validated users to direct subsequent permanent 
file requests to the auxiliary device specified by the 
PN parameter. This command allows the user to omit the PN 
I<eyword in requests for files that reside on that auxiliary 
device. However, if permanent files on another auxiliary 
device are to be accessed, the PN keyword can be included in 
the request or a new PACKNAM command can be entered. 

The user cannot access permanent files residing on the normal 
system devices (family devices) while the PACKNAM 
command is in effect. To access these files again, he must 
enter the PACKNAM command and set the PN parameter to 
zero, as follows: 



PACKNAM,PN=0 or PACKNAM 

An auxiliary device is not necessarily a disk pack that can be 
physically removed as the command name implies. Rather, an 
auxiliary device can be any mass storage device supported and 
defined as such by the site. Auxiliary devices are used to 
supplement the normal mass storage permanent file devices 
associated with the system (family devices). 

Examples: 



OLD.FILEA 



PACKNAM, 
PN=ABC 



Request to normal family device 
for file FILE A. 

Permanent file requests that fol- 
low are made to auxiliary device 
ABC, unless PN option is specified 
in the request or a new PACKNAM 
command is entered. 



GET.DATA -• Request to auxiliary device ABC 

for file DATA. 



PACKNAM, 
PN=XYZ 



GET.TAPEl 
GET,TAPE2 



Permanent file requests that fol- 
low are made to auxiliary device 
XYZ. 

Request to auxiliary device XYZ 
for files TAPEl and TAPE2. 



PACKNAM, Clear PACKNAM command. Perma- 

PN=0 nent file requests that follow are 

made to the normal family devices. 



PERMIT,prn,usernam2=m] , 

usernam2=m2 

usernomp=mn/PN=packnam, 
R=r,NA 



Grants user usornamj permission to access private or 
semiprivate file pfn. If the permission mode, m,, is 
omitted, the system assumes read permission. 
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Ck?mmand 

PURGE,pfni,pfn2 

pfnj,/UN=usemam,PW=passwrd, 
PN=paeknam,R=r,NA 



REPLACE,lfni=pfni, 

Ifn2=pfn2 

If nn=pf nn/U N=userna m , 

PW^a^wrd,PN=paeknam, 

R=r,NA 



SAVE,lfni=pfni, 

Ifn2=pfn2 

If nn=pfnn/PW =passwrd , 
CT=n.lVI =m ,SS=subsyst, 
PN=packnam,R=r,NA 



Description 

Removes the specified permanent files from permanent 
file storage. If the permanent file (pfnj) does not 
exist, the system responds 

pfn NOT FOUND. 

Write permission is required to purge a permanent file in an 
alternate user's catalog (UN keyword specified). The PW 
keyword must also be specified if the file has a password. 
Direct access files are not actually purged until the last user 
accessing the file has released it. However, subsequent 
attempts to access the file are rejected. 

Allows validated users to replace the contents of an 

indirect access permanent file (pfnj) with the 

contents of a temporary file (Ifnj). If the file 

name for pfnj is not specified or does not exist, a 

new pCTmanent file is created. The REPLACE command does 

not affect the subsystem associated with the permanent file (if 

any). 

Creates one or more indirect access permanent files. 
This command allows a validated user to retain a copy 
of the specified temporary file (Ifn;) in the perma- 
nent file system. If the optional keywords are omitted, 
the system assumes the following values. 



PW 
CT 

M 
SS 

PN 

R 

NA 



None. 

Private file. 

Write mode. 

Current subsystem when Ifnj is the primary file. 
Null subsystem when Ifnj is not the primary file. 

None. 



Not applicable unless PN is specified. 



Unless the null subsystem is active when the primary file is 
saved, an internal indicator called the subsystem flag is set to 
indicate which subsystem is being used. That subsystem 
becomes associated with the permanent file (pfnj) and is 
reselected automatically each time the file is retrieved for use 
as a primary file (OLD command or when the Ifn specified on a 
GET command is the current primary file). To associate the 
primary file with a subsystem different from the current 
subsystem, the user can enter the SS=subsyst parameter. To 
save the primary file without a subsystem association, the user 
can enter the SS^NULL parameter. The user can also use the 
SS parameter to associate a subsystem with a temporary file 
that is not the primary file. 
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CATUST COMMAND 

The user can obtain specific information about his permanent files with the CATLIST command. In 
addition, this command can be entered to obtain specific information about permanent files the user can 
access m the catalogs of alternate users. 



COMMAND FORMAT 

The following is the format of the CATLIST command; the optional keywords and corresponding 
parameters must follow the comma and are order independent. 

CATLIST,LO=options,FN=pfn,UN=usernam,L=lfn,PN=packnam,R=r,NA,DN=dn 



Keyword 
L0= 



Parameter 



FP 



Description 

Selects a listing of pertinent information about each file in the 
user's catalog (refer to example 1 under Examples in this 
section). If an alternate user name is specified (UN 
parameter), it selects a listing of the names of all files the 
user can access in the alternate user's catalog (refer to 
example 2 under Examples in this section). The passwords for 
files in an alternate user's catalog are not included in the 
listing; they must be obtained directly from that user. 

Selects a listing of permission information recorded for each 
alternate user that accessed a specified file in the user's 
catalog (refer to example 3 under Examples in this section). 
This option requires that a file name be specified (FN 
parameter). If an alternate user name is also specified (UN 
parameter), only the permission information recorded for that 
user of the specified file is listed. 

The user names listed include: 

• Those that have explicit permission to access the file 
(private or semiprivate file). 

• Those that have implicit permission to access the file 
(semiprivate files only). 

Permission information for alternate users that have accessed 
public files is not recorded. 

Selects a short list that gives only the names of the files in the 
user's catalog (refer to example 4 under Examples in this 
section). Files are listed alphabeticaUy and are grouped as 
indirect access files and direct access files. 
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Keyword Parameter Description 



An asterisk preceding a file name indicates that an error flag 
is set in the eatal<^ entry for the file. The cause of the error 
may be any of the followii^: 

• Alteration of EOI by the recovery proems. 

• Error in verifying BOI/EOI position. 

• Error in data and/or permit entries. 

If the user attempts to attach such a file without specifying 
the NA keyword, lAF issues an error message stating the 
reason for the error status. 

If an alternate user number is specified (UN parameter), the 
user obtains only the names of the files he can access in the 
alternate user^ catalog. 

If no LO parameter is specified, the system assumes LO=0. 

Selects a short list that gives only the user names of alternate 
users who accessed the specified private or semiprivate file 
(refer to example 5 under Examples in this section). TTiis 
option requires that a file name be specified (FN parameter). 



^^~ Pfn Specifies that catalog information is desired only for this 

permanent file (pfn). This parameter is required when listir^ 
permit information (LO=FP, LO=P) but is optional otherwise 

It r\—x! T /-w_n> 



(LO=F, LO=0). 

If a user has several files with similar names, he can list 
information about all of these files usii^ only one FN 
parameter: when specifying pfn, the user inserts an asterisk in 
place of any letter that is not the same in all of his file names. 

Examples: 

FN=***OPL Lists information about all files with 

a six-character file name ending with 
the letters OPL. 

FN=M ****** Lists information about all files with 

a file name beginning with the letter 

M. 

Use of the asterisk is not allowed when listing permit 
information (LO=FP, LO=P). 
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Keyword 



Parameter 



Description 



UN= 



usemam 



L= 



Ifn 



R= 



If the short list options are selected (LO=0, LO=P), the message 

pfn FOUND, 
is returned if the file (or user name) is located. The message 

pfn NOT FOUND, 
is returned if the specified file (or user name) is not located. 
This parameter has two purposes. 

• For LO=F and LO=0. Specifies the alternate catalog 
for which the user wants catalog information (refer 
to example 2 under Examples in this section). 

• Fop T.n=FP nnH T.n=D Ir^^^te: ..1 w. '. 

_- _..„„„ ». ..^tv-jiica iiic aiLernaie user 
for which the user wants recorded permission 
information. 

Specifies the name of a local file to which the CATLIST 
mformation is written. If this parameter is omitted the 
system assumes L=OUTPUT and the data is returned to the 
terminal. If an alternate file is specified, the CATLIST 
infM-mation is written at the current position in the file. For 
example, if Ifn is positioned at BOI, the contents of that file 
are replaced with the CATLIST information. If Ifn is 
positioned at EOI, the CATLIST information is appended to the 
file as a new logical record. 

This parameter is used in conjunction with the PN and NA 
parameters to specify the type of auxiliary device that 
contains the desired catalog information. If PN and NA are 
specified but R is not, the system default device type is 
assumed. If the device type of auxiliary device PN conflicts 
with the device specified by the R parameter, the system 
issues the message 

ILLEGAL DEVICE REQUEST. 

For example, if auxiliary device PN is device type DI and the 
device type specified by R is DK, a conflict exists and the 
error message is issued. 

The device types are 



r 
DE 
nin 
DJn 



Device 



Extended core storage 

844-21 disk storage subsystem (half track; I<n<8) 

844-4X disk storage subsystem (half track; l<n<8) 
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Keyword Parameter Description 

r Device 

DKn 844-21 disk storage subsystem (full track; l<n<8) 

DLn 844-4X disk storage subsystem (full track; l<n<8) 

I DMn 885 disk storage subsystem (half track; l<n<3) 

DP Distributive data path 

I DQn 885 disk storage subsystem (full track; l<n<3) 

n indicates number of units. 

- — x-is-l-or4;' ■ -■ 

_ If the number of units specified does not agree with the actual 

I number for device types DI, DJ, DK, DL, DM, or DQ, the 

system issues the message 

ILLEGAL DEVICE REQUEST. 

PN= packnam The PN parameter identifies an auxiliary device that contains 

catalog information for all users with files on that device. 
Unless the PACKNAM command is in effect, the user must 
specify the PN parameter to obtain the following information 
from his catalog ai an auxiliary device. 

• Pertinent informaticm about each file that resides on 
the device (LO=F). 

• Only the name of each file (LO=0). 

• Permission information for each alternate user that 
accessed a specific file (LO=FP). 

• Only the user number of each alternate user that 
accessed a specific file (LO=P). 

If two or more auxiliary devices are in use concurrently, the 
user must enter the batch subsystem and issue the RESOURC 
ccHitrol statement (refer to the NOS Reference Manual, 
volume 1). The PN keyword can also be specified by alternate 
users to obtain a list of files and pertinent information about 
each file they can access on an auxiliary device. 
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Keyword 
NA 



Parameter 



DN= 



dn 



Description 

This keyword is used in conjunction with the PN parameter in 
requests for catalog information on auxiliary devices. If the 
device is currently not available, NA directs the system to 
make it available. If the NA keyword is omitted and the 
device is not currently available, the system responds 

DEVICE UNAVAILABLE. 

The system does not make the device available unless the user 
is validated to have at least one auxiliary device assigned to 
his job (refer to LIMITS Command in section 4). 

The device number (1 to 77) specified is searched for the files 
that are specified by the CATLIST command options. 



INFORMATION FORMAT 

The format of the first line of information returned for all CATLIST commands is 

CATALOG OF usernam FM/family yy/mm/dd. hh.mm.ss. 

usernam The user name entered during login. 

family The name of the set of permanent file devices on which the user's permanent 

files are stored. If the user specifies the PN parameter in the CATLIST 
command, the system prints PN/packnam instead of FM/family, where 
packnam is the name of the device the user specified with the PN parameter. 

yy/mm/dd The date in year /month/day. 

hh.mm.ss The time in hours, minutes, and seconds. 

The general format of the information returned for a full CATLIST command (LO=F option) is 

FILE NAME ACCESS HLE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 
PASSWORD MD/CNT INDEX PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 



list of files and information 

xxxxx INDIRECT ACCESS FILE(S). TOTAL PRUS = nnnnn. 
xxxxx DIRECT ACCESS FILE(S). TOTAL PRUS = nnnnn. 
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The following are descriptions of the various fields. 



FILE NAME 
ACCESS FILE 

ACCESS TYPE 

LENGTH 
DN 



CREATION 
DATE/TIME 



LAST ACCESS 
DATE/TIME 

LAST MOD 
DATE/TIME 

PASSWORD 

MD/CNT 

INDEX 
PERM. 

SUBSYS 

xxxxx 

nnnnn 



Permanent file name. 

Type of permanent file. This field can be either direct access (DIR) or 
indirect access (IND). 

Method of access or category. This field can be either private (PRIVATE) 
semiprivate (SEMI-PR), or public (PUBLIC). 

Length of the file in decimal PRUs. 

Device number of the mass storage device cm which a direct access file is 
stored. If the file resides cm the master device, this field is replaced by an *. 

Time and date of file creation. Ttie format is 

yy/mm/dd. 
hh.mm.ss. 

Time and date of the last access to the file. 
Time and date of the last modification to the file. 



Pasword associated with the file (field not present if catalog of alternate 
user name). 

Modification count. This number specifies the number of times the file has 
been accessed. 

User index (reserved for system utilities). 

PermissiOTi mode. Entry can be WRITE, MODIFY, APPEND, READ, 
READMD, READAP, or EXECUTE. 

Subsystem under which the file was saved. Possible entries include FOR 
FTNTS, BASIC, EXEC, or BATCH. If this field contains no entry, a 
subsystem is not associated with the file. 

Total of each file type. 

Total of PRUs allocated to each file type. 
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EXAMPLES 

The following examples illustrate some of the options available to the user when enterine the CATLIST 
command. * 



Example 1. 



Listing of pertinent information about each file in the catalog of JLC2016. The 
command is entered by user JLC2016 in the form: CATLIST,LO=F. 



CATALOG OF JLC2016 



FM/NOSCLSH 79/07/30. 08.34.29. 



FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LA<?T kCCF^'i r « qt mah 
PASSWORD MD/CNT INDEX PERM. SUBSYS DATE/TiwE SaTE^TImP DA^E/nME 



1 HEROBAS IND. PRIVATE 

'* WRITE 

2 BASPROG IND. PRIVATE 

1 1.1 D T T T7 

n 1\X i. C, 

3 OCTFILE IND. PRIVATE 

4 WRITE 

4 HEXFILE IND. PRIVATE 

WRITE 

5 ABC IND. PRIVATE 
1234567 1 WRITE 

6 TAPE3 IND. SEMI-PR 

9 READ 

7 BINTAPE IND. PUBLIC 
BINARY 2 EXEC 

8 PRIME IND. SEMI-PR 

6 READ 

9 DIRFILE DIR. PRIVATE 

WRITE 

10 DIRTEST DIR. PRIVATE 

1 WRITE 

8 INDIRECT ACCESS FILE(S) 
2 DIRECT ACCESS FILE(S), 



1 79/07/12, 
BASIC 08.17.15. 

J.r,^ 79/07/26. 
BASIC 07.46.02. 

1 79/07/26. 
FTNTS 08.21.05. 

1 79/07/26. 
FTNTS 08.27.08. 

1 79/07/30. 
BASIC 08.03.32. 

1 79/07/30. 
BASIC 08.06.04. 

1 79/07/30. 
EXEC. 08.07.56. 

1 79/07/30. 
FORT. 08.17.11. 

2 » 79/07/30. 

08.23.08. 

2 » 79/07/30. 
08.23.16. 



TOTAL PR US 
TOTAL PR US 



79/07/13. 
08. 19. 15. 

79/07/26. 
07.51.02. 

79/07/26. 
08.25.54. 

79/07/26. 
08.27.08. 

79/07/30. 
08.04.02. 

79/07/30. 
08.12.33. 

79/07/30. 
08.08.12. 

79/07/30. 
08.28.33. 

79/07/30. 
08.23.08. 

79/07/30. 
08.27.54. 

8. 
4. 



79/07/13. 
08.19.15. 

79/07/26, 
07.48.02, 

79/07/26. 
08.22.37. 

79/07/26. 
08.27.08. 

79/07/30. 
08.03.32. 

79/07/30. 
08.06,04. 

79/07/30. 
08.07.56. 

79/07/30. 
08.17.11. 

79/07/30. 
08.23.08. 

79/07/30. 
08.23.16. 



Subsystem associated with the file. 
Blank entry indicates the null subsystem 
or no subsystem association. 
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Example 2. Listing of pertinent infcx-mation about each file that KXK4277 can access in the 

catalog of JLC2016. The command is entered by user KXK4277 in the form- 
CATLIST,LO=F,UN=JLC2016. 

CATALOG OF KXK4277 FM/NOSCLSH 79/07/30. 08.38.56 

ALTERNATE CATALOG JLC2016 uo.:so.dd. 

FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 
MD/CNT INDEX PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 



1 ABC 

2 TAPE3 

3 BINTA-PE 
M PRIME 



IND. PRIVATE 
1 

IND. SEMI-PR 
9 



IND. 
2 



PXJBLrC 



IND. SEMI-PR 
6 



5 DIRFILE DIR. PRIVATE 



6 DIRTEST DIR. PRIVATE 

1 



1 79/07/30. 79/07/30. 79/07/30. 

READ BASIC 08.03.32. 08.04.02. 08.03.32. 

1 79/07/30. 79/07/30. 79/07/30. 

READ BASIC 08.06.04. 08.12.33. 08.06.04. 

1 79/(57730.79/07/30.79/07/30. 

EXEC EXEC. 08.07.56. 08.08.12. 08.07.56. 

1 79/07/30. 79/07/30. 79/07/30. 
READ FORT. 08.17.11. 08.28.33- 08.17.11. 

2 • 79/07/30. 79/07/30. 79/07/30. 
READ 08.23.08. 08.23.08. 08.23.08. 

2 » 79/07/30. 79/07/30. 79/07/30. 

READ / 08.23.16. 08.27.54. 08.23.16. 



Example 3. 



4 INDIRECT ACCESS FILE(S), / TOTAL PRUS = 4 
2 DIRECT ACCESS FILE(S), / TOTAL PRUS = 4: 

DN indicates device number for direct access 

files. An * in this column indicates that file 

resides on master device (refer to appendix C). 

Listing of permission information recorded for each user that has accessed file 
PRIME (semiprivate file) in the catalog of JLC2016. The command is entered bv 
user JLC2016 in theform...CATLIST,LO=FP,FN=PRIME. 



CATALOG OF JLC2016 

FILE NAME PRIME 
USER NUMBER PERM. ACCESSES DATE 



FM/NOSCLSH 79/07/30. 08.21.48. 



TIME 



1. KXK4277 READ* 

2. RXL3530 WRITE»> 



2 79/07/30. 08.19.19. 

3 79/07/30. 08.20.24. 



An asterisk indicates explicit permit (set by PERMIT command) 
rather than accounting permit (used on semiprivnte files). 
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Example 4. List of current files in the catalog of JLC2016. The command is entered by user 

JLC2016 in the form...CATLIST,LO=0 (it is not necessary to specify the LO=0 
option since it is the default value). The asterisk indicates error status set. 

CATALOG OF JLC2016 FM/NOSCLSH 79/07/30. 08.23.48. 

INDIRECT ACCESS FILE(S) 

ABC BINTAPE EXAM HEROBAS HEXFILE OCTFILE TAPE3 
BASPROG DATA GRADES HEROFTN LIST PRIME 

DIRECT ACCESS FILE(S) 

DIRFILE DIRTEST 

13 INDIRECT ACCESS FILE(S) , TOTAL PRUS = 18 
2 DIRECT ACCESS FILE(S), TOTAL PRUS = i» . 



Example 5. List of alternate users that have accessed file PRIME in the catalog of JLC2016. 

The command is entered by user JLC2016 in the form: CATLrST,LO=P,FN=PRIME. 

CATALOG OF JLC2016 FM/NOSCLSH 79/07/30 08 ^1 ^it 

FILE NAME PRIME i^f^i/5V. UQ.i■^.3^. 

USER NUMBER(S) 

KXK1277 RXL3530 
2 USER(S) 



I 



ALTERNATE USER ACCESS 

The following examples illustrate the alternatives available to users for accessing files in alternate 



PRIVATE FILE CATEGORY 

?oE!r'^eommaS^ '^ retained by user JLC2016 as a private indirect access permanent file using the 
SAVE,ABC/PW=1234567 



60455250 C 

5-21 



The following is the entry for file ABC in the catalog of JLC2016. The listing is obtained by entering 
the CATLIST command in the form: CATLIST,LO=F,FN=ABC. 



CATALOG OF JLC2016 



FM/NOSCLSH 79/07/30. 08.04.11 



FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 
PASSWORD MD/CNT INDEX PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 



1 ABC IND. PRIVATE 1 79/07/30. 79/07/30. 79/07/30. 
123t567 1 WRITE BASIC 08.03.32. 08.04.02. 08.03-32. 

1 INDIRECT ACCESS FILE(S), TOTAL PRUS = 1. 

User JLC2016 issues the following command to permit alternate user access. 

PERMIT,ABC,KXK4277=R.DLH2500=W 

The following is the permission information recorded in the catalog of JLC2016. The listing is obtained 
by entering the CATLIST command in the fo-m: CATL1ST,L0=FP,FN=ABC. 



CATALOG OF JLC2016 

FILE NAME ABC 
USER NUMBER PERM. ACCESSES DATE 



FM/NOSCLSH 79/07/30. 08.05. 18. 
TIME 



1. KXKM277 READ* 

2. DLH2500 WRITE' 



79/07/30. 08. on. 56. 
79/07/30. 08.04.57. 



An asterisk indicates explicit permit fl{^. 

The format of the command required of KXK4277 and DLH2500 to access the file is 

GET,ABC/UN=JLC2016,PW=1234567 or OLD,ABC/UN=JLC2016,PW=1234567 
Only the following users can access this private file. 



User 


Informaticm Necessary for Access 


JLC2016 


File name 


ABC 


KXK4277 


File name 
File password 
User name 


ABC 

1234567 

JLC2016 


DLH2500 


File name 
File password 
User name 


ABC 

1234567 

JLC2016 
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SEMIPRIVATE FILE CATEGORY 

Temporary file TAPE3 is retained by JLC2016 as a semiprivate indirect access permanent file usim the 
loiiowmg command. " 

SAVE,TAPE3/CT=SPRIV,M=READ 

l^^rf^^i^ ^ ^"^ ^T-^ f^ 9^ '^^^^^ '" ^^^ '^^t*^*^ °f JLC20I6. The listing Is obtained by entering 
the CATUST command in the form: CATLIST,LO=F,FN=TAPE3. c"i«=iii^ 



CATALOG OF JLC2016 



FM/NOSCLSH 79/07/30. 08.06.33. 



FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACPF^^ T i<?T Mr.n 

PASSWORD HD/CNT INDEX PERM. SUBSYS DA?E/TIME SaTeJtiSe DATE/tKe 

1 TAPE3 ind semi-PR i 79/07/30. 79/07/30. 79/07/30 

3 READ BASIC 08.06.0i.. 08.06,1?: O8.O6.0?: 



1 INDIRECT ACCESS FILE(S), TOTAL PRUS = 



1 



The foUowir^is the permission information recorded in the catalog of JLC2016. The listing is obtained 
by entering the CATLIST command in the form: CATLIST,LO=FPrFN=TAPE3. ^ obtamed 



CATALOG OF JLC2016 

FILE NAME TAPE3 
USER NUMBER PERM. ACCESSES DATE 



FM/NOSCLSH 79/07/30. 08.13.21 



TIME 



1. KXK4277 READ* 

2. RXL3530 WRITE* 



'4 79/07/30. 08.11.27. 
2 79/07/30. 08.12.33. 



The listing shows that two users have accessed file TAPE3 the indicated number of times. When an 

"i^T/^In^^^'r-^T^^^ "^^ "^^"^^^ *^® "'■^* "'"^' *^^ permission information is recorded in the catalog 
ot JLCZ0I6. Each succeeding access increases the access count (ACCESSES). The absence of an asterisk 
alter the permission mode indicates that this is an accounting permit and was not created by a PERMIT 
command. ^ 

The format of the command required of all users, except JLC2016, to access the file is 

GET,TAPE3/UN=JLC2016 or OLD.TAPE3/UN=JLC2016 
Users who can access this file are: 

User Information Necessary for A ccess 

JLC2016 File name TAPE3 

All others 



File name 
Password 
User name 



TAPE3 

None required 

JLC2016 



60455250 C 



5-23 



PUBLIC FILE CATEGORY 

Temporary file BINTAPE is retained by JLC2016 as a public indirect access permanent file using the 
following command. 

SAVE,BINTAPE/PW=BINARY,CT=PUBLIC,M=EXECUTE 

TTie following is the entry for file BINTAPE in the catalog of JLC2016. The list is obtained by entering 
the CATUST command in the form: CATLIST,LO=F,FN=BINTAPE. 

CATALOG OF JLC2016 FM/NOSCLSH 79/07/30. 08.08.21. 

FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ArrF<?<? i i<;T Mr.n 
PASSWORD MD/CNT INDEX PERM. SUBSYS DAtJJtIME dSe/?i5e DATeJtSmI 

' IIVA? ^""p '"^^^^ .vr. ' 79/07/30. 79/07/30. 79/07/30. 

^^^^^^ 2 EXEC EXEC. 08.07.56. 08.08.12. 08.07.56. 

I 1 INDIRECT ACCESS FILE(S), TOTAL PRUS = i. 

Permission information is not recorded for accesses to a public file; only the total number of accesses is 
recorded fw the originator of the file. 

The fwmat of the command required of all users, except JLG2016, to access file BINTAPE is 

GET,BINTAPE/UN=JLC2016,PW=BINARYor OLD,BINTAPE/UN=JLC2016,PW=BINARY 
Users who can access this file are 

User Informatioi Necessary for Access 

JLC2016 Filename BINTAPE 

All others File name BINTAPE 

Password BINARY 

User name JLC2016 

LIBRARY COMMAND 

The LIBRARY command allows access to indirect access permanent files in the catalc^ of special user 
name LIBRARY. Direct access files can also reside in the catalog of LIBRARY althoigh an alternate 
method must be used to access these files (described later in this section). The file category is private, 
semiprivate, or public. The permission mode is that which has been granted for private files or specified 
in the catalog for semiprivate and public files. 

When the LIBRARY command is entered, a copy of the specified indirect access permanent file is 
relieved. This copy becomes the new primary file and all other local files are dropped unless the ND 
parameter is used. For example: 

LIBRARY ,ABC75/PW=13479,ND 

In this example, a copy of indirect access permanent file ABC75 is retrieved and becomes the new 
primary file; all local files remain associated with the job. Only indirect access permanent files can be 
accessed with the LIBRARY command. 
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?]!?-^°^°"'"S commands can also be entered to access permanent files in the catalog of UBRARY 
(differences in command function are described). 

ATTACH,lfn=pfn/UN=LlBRARY,PW=passwpd,M=m 

This command must be entered to use any direct access permanent files in the catalog of 
LIBRARY. A temporary file is not created since all I/O operations are performed directly on 
the permanent file itself. However, if the user wishes to reference the file by a name other 
than Its permanent file name, he can assign a local file name (Ifn) in the command. The primary 
file name remains unchanged. 

GET,lfn=pfn/UN=LIBRARY,PW=passwrd 

This command retrieves a copy of the specified indirect access permanent file (from catalog of 
LIBRARY) for use as a temporary file. The primary file remains unchanged unless Ifn specifies 
the name of the current primary file (refer to description of GET command). 

OLD,lfn=pfn/UN=LIBRARY,PW=passwrd 

The function of this command is identical in all respects to that of the LIBRARY command. 

The only files that can be accessed from the catalog of LIBRARY are those that allow alternate user 
access. All users, except user number UBRARY, are considered to be alternate users. The rules for 
alternate user access are summarized as follows: 

• Only those users with permission can access private files. 

• All users can access semiprivate and public files providing they i<now the file name, password (if 
one exists for the file), type of access (direct or indirect), and user number (LIBRARY). 

The foUowing forms of the CATLIST command can be entered to obtain a listing of files that can be 
accessed in the catalog of UBRARY. 

CATLIST,LO=F,UN=LIBRARY (full listing) 

CATLIST,UN=LIBRARY (file names only) 
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ADDITIONAL SYSTEM FEATURES 



This section contains descriptiais of the program editing, line resequencing, job suspension, and recovery 
features provided for the terminal user. 



PROGRAM EDITING 

To allow ease of editing the primary file when working with source programs, lAF provides a line editing 
capability that can be used under any subsystem. For more detailed editing, Text Editor or XEDIT should 
be used (refer to the Text Editor Reference Manual or the XEDIT Reference Manual). The line editing 
capability allows the user to 

• fiisert statements into a program. 

• Delete statements from a program. 

• Correct statements in a program. 

The following example illustrates this program editing capability. The user enters a new primary file. 

10 let a=1 

20 let b=50 

30 for i=l to b 

40 a=a»i 

50 print "factorial" ;i, a 

60 next i 

70 end 



If the user wishes to insert a statement between line numbers 10 and 20, he types 

15 let z=20 

If the user wishes to delete the statement at line 20, he types 
20 
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Finally, to change the statement at line number 30, the user types 
30 for 1=1 to z 

tlfh^lnilT ^'^ "°^ '^'^"''■^ ^"^^ '^ *^^ statement being deleted or corrected contains line numbers 
number^ O^OoT'* ''""'''' " ""' ""'"^''■"' '° ""^P^^^^^' «"^ '' interchangeable wfth. a line 

When the file is listed, it has the foUowir^ form. 

Inh 

10 LET A=1 

15 LET Z=20 

30 FOR 1=1 TO Z 

40 A=A»I 

50 PRINT "FACTORIAL"; I. A 

60 NEXT I 

70 END 

READY. 



To retain the latest (corrected) version of the primary file, the user enters 
save 

JLiUfoS^fi)' ^"^i' ^ ''°?^?I ^" ''^'"^''^ «^^^ permanent file, the user can replace the version in the 
permanent file system with the corrected version by entering version in me 

replace 

To save the corrected file under a new name, the user enters 
save,lfn=pfn 

Ifn Primary file name, 

pfn Permanent file name. 



RESEQUENCING LINE NUMBERS 

r^lS^^^^ command enables the user to resequence or add line numbers to the primary file The user 
should resequence only sorted files. This is done using the following command. ^"""^'^ '''^- ''^^"^^'^ 

RESEQ,nnnnn,iiii,t 

nnnnn N^^Jne ^mber of the first statement (five digits maximum); if omitted. lAF assumes 

iiii Increment to be added to nnnnn; if omitted. lAF assumes iiii is 0010. 
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other 



Default 



Type of file to be resequenced: 

B Files that contain BASIC source code. BASIC statements that contain 

references to line numbers are updated when the line numbers are 
resequenced. 

T Files that contain text source information. A five-digit line number, 

plus a blank, is added at the beginning of each line. No inspection is 
made for existir^ line numbers. Thus, if line numbers currently exist, 
they are not resequenced or deleted; two sets of line numbers result. 

Any number at the b^inning of a line is considered a line number and 
is resequenced according to the nnnnn and iiii parameters; line 
numbers are added to the beginning of lines where none appear. 

The user must change to the correct subsystem before entering the 
RESEQ command. 

BASIC programs are resequenced under the BASIC subsystem. If the 
user resequences a BASIC source file, all line number references are 
updated. The format of each BASIC statement remains the same 
unless a new line number reference contains more digits than the 
original line number reference. Then, any multiple blanks surrounding 
the original line number reference are used for the expanded number. 

FORTRAN programs are resequenced under the FORTRAN or FTNTS 
subsystem; statement numbers and references to statement numbers 
are not changed. 

All parameters supplied in the RESEQ command are order dependent; that is, they must be entered in the 
order they appear in the command. Omitted parameters must be indicated by a comma if other 
parameters are to follow. For example, the command 

RESEQ,50„T 

adds line numbers to the primary (text) file without cheeking for existing line numbers. Thus, the first 
line is numbered 00050 and each succeeding number is increased by 10 (default value). If the T 
parameter is not specified in the command, the two preceding commas are not necessary. 

If the starting line number (nnnnn parameter) is longer than five digits or if the increment (iiii 
parameter) causes the line numbers generated to exceed five digits, the message 

LINE NUMBER LIMIT EXCEEDED, 
is returned to the terminal. In addition, the message 

RESEQ NUMERIC PARAM ERROR, 
is returned if the user enters a nonnumeric value for either the nnnnn or the iiii parameters. 
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JOB SUSPENSION 



IL^l^wl f^Tf !! ^°^ '^"""? program execution by entering the interruption sequence (refer to 
appendix F for default interruption sequences for all terminal classes). If the program is actively 
transmitting output to the terminal, the BREAK (or ATTN) key must first be pressed to inhibit output. 
The interruption sequence can then be entered to suspend the job. lAF responds 

♦INTERRUPTED* 

If the user's terminal does not have a BREAK key (sometimes labeled INT, INTRPT or ATTN) a iob 
cannot be suspended while it is transmitting output to the terminal. ' ' 



I NOTE 



On asynchrwious terminals (terminal classes 1 
through 8), output can be suspended by pressing 
any key. Kowever, then the interruption sequence 
cannot be entered. To use the interruption 
sequence, the BREAK key must be used to suspend 
output. 



A job is also suspended automatically by lAF when: 

• A successful recovery has been performed (refer to Recovery in this section). 

I • The job has exceeded its time limit. The time limit is initially set to 64 seconds at locin 

although the user can change this value through use of the SETTL command (refer tolection 4). 

I • The job or job step has exceeded its SRU limit. The SRU limits are initially set to 320 SRUs at 

(?ffer to Section 4^^^"" ''^" """^"^^ ^^'^ "^^"^ *^'"°"^'' "^^ °^ ^^^ SETASL or SETJSL commands 

^^o^thrfoUoISngf"''^'"^' '^ ^^^ ^°^ *" suspended by the user (interrupted) or by lAF, the user can enter 
^try DeseriptJOTi 

@ Continues output. A portion of the output is lost if the program was transmitting 

output to the terminal when suspended. When output is complete, program execution 

P @ Proceeds. If the program was transmitting output to the terminal when suspended, the 

^stem discards the data generated by the program prior to the interruption sequence. 
The amount of output discarded depends on the program being executed. ProOTan 
execution continues. ^ 

Other @ Stops. Terminates the job step. 

If the job is suspended because a job step exceeded its time limit, the message 

•TIME LIMIT* 

ENTER T TO CONTINUE OR CR KEY TO STOP: 
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is issued and the user can enter one of the following; 
Entry 
T @ 



Description 



T.nnnnn @ 

@ 

Termination character @ 



Increases the central processor time limit by an amount defined 
by the site. Job execution continues. 

Increases the central processor time limit by nnnnn decimal 
seconds. Job execution continues. 

Causes the job to go through normal abort procedures (for 
example, EXIT processing which can be useful when using 
procedure Hies). 

Terminates the job step. Subsequent control statements, if any, 
are not processed. 



If the job is suspended because a job step or the job itself exceeded its SRU Umit. the message 

*SRU LIMIT* 

ENTER S TO CONTINUE OR CR KEY TO STOP: 

is issued. The user can enter one of the following: 

^"^y Description 



S @ 

S, nnnnn @ 

@ 

Termination character @ 



Increases the SRU limit by an amount defined by the site. Job 
execution continues. 

Increases the SRU limit by nnnnn decimal units. Job execution 
continues. 

Causes the job to go through normal abort procedures. 

Terminates the job step. Subsequent control statements, if any, 
are not processed. 



The following example illustrates the use of the interruption sequence to interrupt a FORTRAN program. 
Inh 

00100 PROGRAM DO (INPUT, OUTPUT) 

00110 INTEGER E 

00120 DO 10 E= 1,300 

00130 WRITE 5,E 

001 MO 5 F0RMAT(I3) 

00150 10 CONTINUE 

00160 READ*, I, J 

00170 WRITE 15, I, J 

00180 15 FORMAT(I3,I3) 

00190 STOP 

00200 END 
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rnh 



1 
2 
3 



•INTERRUPTED* 

@ -« 

110 
111 
112 



•INTERRUPTED* 



193 
194 

195 



•INTERRUPTED* 
p@-« — 

? 4,5 
'\ 5 

SRU 0.863 UNTS, 

RUN COMPLETE. 



User interrupts the BREAK key to stop output and 
enters the interruption sequence to suspend the job. 
User continues by pressing @) (some output is lost). 



• User ^ain presses the BREAK key to stop output and 
enters the interruption sequence to suspend the job. 

• User enters P@, directing the system to discard 
data. As execution continues, more data is printed at 
the terminal. 



■ User again suspends the job. 

■ User enters P@, directing the system to discard 
data. All output has been generated. Program 
execution continues. 

The number of times the user would have to enter P 
^ before all output has been generated depencte on 
the program. 



I In the foUowing example, a program exceeds its allocated time limit. The user enters T to increase the 
time limit and thp nroorram then r-ima tn or>nirv1o4ir». s.».^b.3<= 



time limit and the program then runs to completion. 



Inh 

00100 PROGRAM T(OUTPUT) 
00110 DO 6 1=1,2500 
00120 DO 6 J= 1,4000 
00130 A=1 
00110 6 CONTINUE 
00150 END 

READY. 
settl,10 



READY, 
rnh 

•TIME LIMIT* 

ENTER T TO CONTINUE OR CR KEY TO STOP: 
t 

SRU 66.835 UNTS. 

RUN COMPLETE. 
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RECOVERY 

During job processing, recovery may be necessary when: 

• TTie terminal is accidentally disconnected from the system. 

• A system malfunction occurs which requires a restart. 

The terminal is placed in recovery state whenever it is disconnected from the system without beine 
logged out (providing that it is not already in recovery state). The user has 10 minutes to initiate 
recovery. 

If there is a system malfunction which requires a restart, the user has 10 minutes from the time lAF is 
restarted to mitiate recovery. 

l%^^;^^i-^^^^J^J^ratitetes the login sequence to the point where lAF requests RECOVER/SYSTEM (or 
KtOOVER/CHARGE). For example: 

79/07/26. 08.05.45. L21T1 

(35) CYBER 171 S/N 620 CLSH. NOS 1-8J02T/R2B 

FAMILY: , jlc2016, jle2 ^x/n^o. 

TERMINAL: 21, NAMIAF 

RECOVER/ CHARGE: 



In response, the user enters 
RECOVER.nnn 

nnn Terminal number being used when the failure occurred. This number was indicated 

when the user initially logged in (refer to preceding example). If the same terminal 
number is indicated when the user logs in to recover, this parameter is not required. 

The RECOVER command is valid only when entered in response to the RECOVER/SYSTEM or 

RECOVER/CHARGE request during the login sequence. If the user's terminal number is not the same as 

betore the failure, the previous terminal number must be entered with the RECOVER command (nnn 

parameter). This may occur when the failure is due to a dropped Hne connection, m this case, a 

o^™io "^* ".""^''^'' ""^y ^ assigned at login because of telephone switching rotaries. If the 

th^ rS/^T"" 'L"*'* ^"^^'f'^ ""^^^ indicated, the user may log out, log in again, and then enter 
me KtcOVER command correctly. 

If lAF responds RECOVERY IMPOSSIBLE, one of the following conditions exists. 

• '^J^f^"' ^ "° '■^"'^ °^ *^^ specified user being logged in on the given terminal number 
within the past 10 minutes. 

• The user's system information is incorrect due to system malfunction. 

If lAF responds INVALID TERMINAL NUMBER, the terminal number the user entered has a format or 
size error. 
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If the user receives either of the preceding messages, he should check the terminal number he entered. 
It he has not given the correct number, he may reenter RECOVER with the correct terminal number. 

If recovery is successful, the system responds 
RECOVERY COMPLETE. 

LAST COMMAND = name 

JOB STATUS = Stat 

NEXT OPERATION = nnnn 

ENTER *CR* TO CONTINUE: 
name 



Stat 



nnnn 



Name of last command processed. If source code was being entered, the word source 
is output. 

One of the following job status messages. 
Message 



IDLE 

EXECUTING 
OUTPUT AVAILABLE 
OUTPUT LOST 
INPUT REQUESTED 
INPUT LOST 
One of the followii^ next operation messages 
Message 



Description 
No activity. 
Job is in execution. 

Output from an executing job is available. 
Output from an executing job is lost. 
Executing job is requesting input. 
Last line of input data is lost. 



ENTER COMMAND 
RERUN OR CONTINUE 

ENTER DATA 
REENTER DATA 
CONTINUE 



Description 

lAF is ready to process the next command. 

If output, transparent mode input, or auto mode 
input is lost, and if the output or input are 
significant, the user should rerun the job. 

Executing job is requesting input. 

User should reenter lost input data. 

Executing job is ready to continue processing. 



6-8 



60455250 C 



The user must then enter @ to restart his job. If the job was previously transmitting output, the output 
data normally resumes a few lines prior to where the interruption in service occurred. 

In general, recovery in lAF is designed to provide minimum inconvenience to the user with maximum 
security. However, under certain circumstances, recovery of user information cannot be perfect. The 
following are two examples of these circumstances. 



• 



In some cases, a few lines of output may be lost when a phone line is disconnected just as a job 
is being restarted to generate more output. This actually occurs before current output is 
exhausted. 

• If a phone line is disccmnected when a user is entering source code, he can normally expect to 
lose the last few lines of text he has entered. 

Whenever the user name and terminal number of a user requesting a recovery state match the user name 
and terminal number of a user already in a recovery state, the user already in tl^e recovery state remains 
there and the other user is lo^ed out. If a user is disconnected after logging in but before recovery from 
a previous disconnect, the latter time is processed as a normal logout to protect the user from an 
intermittent phone Une failure. The user can then log in again and enter the RECOVER command to 
continue the job. 



The following is an example of a normal recovery. 



79/07/26. 08.07.17. L21T1 

(35) CYBER 17t S/N 620 CLSH. NOS 1-8J02T/R2B. 

FAMILY: 

USER NAME: jlc2016 
PASSWORD 
•IMMII 

TERMINAL: 21, NAMIAF 
RECOVER/ CHARGE: recover, 23 

RECOVERY COMPLETE. 

LAST COMMAND = RNH 

JOB STATUS = IDLE 

NEXT OPERATION = ENTER COMMAND 
ENTER »CR» TO CONTINUE: 



The user enters @ to continue job processing. 
lAF replies 
READY. 
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The following example illustrates a sample recovery. 

79/07/26. 08.17.03. L28T1 

ci^^?."^^'' ^"^^ ^^^ ^20 CLSH. NOS 1-8J02T/R2B. 

FAMILY: 

USER NAME: jlc20l6, jlc2, iaf 

TERMINAL: 5, NAMIAF 

RECOVER/ CHARGE: char ,5923, 693ni»51 

READY. 
old,aa 

READY. 
Inh 

00100 PROGRAM AA (INPUT, OUTPUT) 
00110 PRINT 4 

00120 H FORMAT (» ENTER 2 NUMBERS IN THE FORMAT XXX. X XXX. X«) 

00130 READ 3,A,B 

00140 3 F0RMAT(F5.1,1X,F5.1) 

00150 C=A«B 

00160 PRINT 5,C 

00170 5 FORMAT(«A MULTIPLIED BY B EQUALS* , 1X,F15.2) 

00180 STOP 

00190 END 

READY, 
rnh 



9 



ENTER 2 NUMBERS IN THE FORMAT XXX. X XXX. X 



- The user is disconnected before entering data and 
logs in again. 



79/07/26. 08.18.26. L28T1 

(35) CYBER 174 S/N 620 CLSH. NOS 1-8J02T/R2B 

FAMILY: ouu,ii,n*:D. 

USER NAME: jlc2016 , jlc2,laf 
TERMINAL: 5, NAMIAF 
RECOVER/ CHARGE: recover, 5 

RECOVERY COMPLETE. 

LAST COMMAND = RNH 

JOB STATUS = INPUT REQUESTED 

NEXT OPERATION = ENTER DATA 

ENTER »CR» TO CONTINUE:-. The user enters @ to continue. 

? 20.0 20.0 -. The user enters data. 

A MULTIPLIED BY B EQUALS 400.00 

SRU 0.686 UNTS. 

RUN COMPLETE. 
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"rtiis example illustrates another recovery situation. 



enquire 




TERMINAL: 2H, 


NAMIAF 


SYSTEM: BASIC 




FILE NAME: BB 




STATUS: IDLE 




MESSAGE: 




Inh 





10 REM THIS IS A TEST 

20 REM PRINT B 

30 PRINT "PRINT B" 

40 LET B=1+3 

50 PR-INT S 

60 END 



READY. 



■ The user is disconnected. 



79/07/26. 08.14.16. L32T1 

(35) CYBER 174 S/N 620 CLSH. 
FAMILY: 

USER NAME: jlc2016, jlc2,iaf 
TERMINAL: 26, NAMIAF 
RECOVER/ CHARGE: 



NOS 1-8J02T/R2B, 



■ The user is disconnected again before recovering. 
This is processed as a normal logout. 



L32T1 
620 CLSH. 



79/07/26. 08.15.01. 
(35) CYBER 174 S/N 
FAMILY: 

USER NAME: jlc2016, jlc2, iaf 
TERMINAL: 26, NAMIAF 
RECOVER/ CHARGE: recover, 24-^ 



NOS 1-8J02T/R2B, 



■ The user enters the RECOVER command. 



RECOVERY COMPLETE. 

LAST COMMAND = LNH 

JOB STATUS = IDLE 

NEXT OPERATION = ENTER COMMAND 

ENTER »CR» TO CONTINUE:-" 

READY. 
Inh 

10 REM THIS IS A TEST 

20 REM PRINT B 

30 PRINT "PRINT B" 

40 LET B=1+3 

50 PRINT B 

60 END 

READY. 



■ The user enters @ to cwitinue. 
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ERROR CONTROL 

When the hardware detects an error condition, the system terminates the job step and dumps the job's 
exchange package and a portion of the job's central memory to a local mass storage file called 
ZZZDUMP. The following message is printed. 

EXCHANGE PACKAGE/MEMORY DUMP ON FILE ZZZDUMP. 

To examine the exchange package and memory dump, rewind and list file ZZZDUMP. Refer to the NOS 
Reference Manual, volume 1, for more information on the exchange package and error conditions. 
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REMOTE JOB SUBMITTAL 



GENERAL DESCRIPTION 



Remote job submittal enables a validated lAF user to submit batch job deck images to the system for 
processing. The batch job image can be created interactively at the terminal and then submitted to the 
local batch queue by entering the SUBMIT command. The user is no longer interactive with the job once 
It has been submitted. Instead, the job is treated in the same manner as a job entered from the card 
reader at the local computer site or from a remote batch terminal (through RBF). The batch job image 
can consist of control statements, control language statements, program statements, and data. The 
structure of the batch job image must also be the sameaa its counterpart on car^s (job <leck).The-Hser 
can specify how the job is to be structured through use of the reformatting directives described in this 
section. Refer to the NOS Reference Manual, volume 1, for information concerning job structure and a 
description of the control statements available. 

SUBMIT COMMAND 

The format of the SUBMIT command is 
SUBMIT,lfn,q,NR,c 

Ifn Specifies name of local file to be submitted for processing as a deferred batch job. If 

Ifn is omitted, the primary file name is assumed. The primary file is sorted before 
being submitted. 

q ^ecifies the disposition of job OUTPUT as follows: 

B The job is processed as a local batch job and file OUTPUT is printed at the 
central site. 

N The job is processed as a local batch job and file OUTPUT (including banner 
page and dayfile) is not printed. The default is N. 

E The job is processed as a remote batch job and file OUTPUT is routed for 
printing at a remote batch terminal. 

NR Specifies no rewind option; inhibits rewind of file specified by reformatting directive 

cREAD (refer to Reformatting the Submit File in this section). If omitted, file 
specified by cREAD directive is automatically rewound. 

c Specifies escape character used to identify reformatting directives in the file to be 

submitted (Ifn). If omitted, lAF assumes c is a slash. 



60455250 C 



7-1 



After the job has entered the batch queue, lAF responds 

hh.mm.ss.jobname 
READY. 



hh.mm.ss. Time that the job entered the batch queue (hours, minutes, seconds). 

jobname Seven-character job identification name assigned to the job by the system when it 

is submitted. 

The last three characters of the job identification are entered with the ENQUIRE, JN=ccc command to 
obtain the status of a job after it has entered the system (refer to ENQUIRE command in section 4). 



REFORMATTING THE SUBMIT FILE 

The submit fUe (Ifn in the SUBMIT command) is a file which contains the batch job image submitted for 
processing, ihe reformatting directives described in this section are provided to aid the user in 
preparing the submit file. When the SUBMIT command is entered, the submit file is reformatted 
according to the directives that appear in the file and is then placed in the batch input queue awaiting 
execution. Thus, several of the directives are provided to format the submit file to meet the structural 
requirements of a batch job (refer to the NOS Reference Manual, volume 1). 

Each line in the submit file preceded by an escape character is recognized as a reformatting directive. 
The escape character to be used can be defined in the SUBMIT command (/ by default). Throughout this 
description, the letter c, preceding a directive, denotes the escape character. Reformatting directives 
can be interspersed throughout the submit file as long as transparent mode is not in effect. Transparent 
mode is selected by the cTRANS directive; it requires that the user observe special rules when inserting 
subsequent directives into the file (refer to the description of cTRANS and cNOTRANS directives). 

Reformatting directives are not processed unless the first line of the submit file contains the eJOB 
directive. In addition, the first two statements following the cJOB directive (second and third lines of 
the submit file) must be a job and USER statement, respectively. All following information is 
determined by the user. Thus, the first lines of a submit file that is to be reformatted before proeessine 
should be f b 

00100 cJOB Reformatting directive. 

00110 JOBNAME,... Job statement. 

00120 USER,... USER statement. 

00130 CHARGE.... Charge and project numbers, if required. 



NOTE I 



The job and USER statements are required in 
all batch jobs; they must be present even 
though the cJOB statement is omitted. If the 
user submits a job with an illegal USER 
statement, lAF logs the user out without a 
dayfile message and decrements his security 
count. The user can log in again if his security 
count is greater than zero. For more 
information on use of the USER control 
statement, refer to section 8. 
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Although text mode can be used to create a submit file, it is not necessary since each line may have a 
leading line number. The cSEQ and cNOSEQ directives determine, during reformatting, if line numbers 
in the submit file wiU be retained. The cJOB directive is required when any line numbers are to be 
removed. The user can include line numbers on the entire submit file and can specify which line numbers 
are to be removed during reformatting. This is especiaUy useful if the submit file contains a BASIC 
EX"ogram where line numbers are a requirement of the language. 

The reformatting directives available are described as follows: 



Directive 



cJOB 



cEOR 

cEOF 

cSEQ 

cNOSEQ 

cPACK 

cNOPACK 
cTRANS 



Description 

Indicates that the submit file is to be reformatted and selects the following 
defaidt reformatting directives. The default directives remain in effect until 
specified otherwise. 

cNaTRANS (<HsaMe<3by«-TRANS) 

cSEQ (disabled by cNOSEQ) 

cPACK (disabled by cNOPACK) 

The cJOB directive must be the first line of the submit file. If omitted, the file is 
not reformatted. 

Indicates that an end-of-record mark is to be placed at this point in the submit 
file during reformatting. 

Indicates that an end-of-file mark is to be placed at this point in the submit file 
during reformatting. 

Indicates that line numbers will be removed from all subsequent lines during 
reformatting (default value). 

Reverses the effect of the cSEQ directive. No attempt is made to remove leading 
line numbers from subsequent lines. 

Indicates that all succeeding internal EOR and EOF marks will be removed during 
reformatting (default value). This directive applies only to internal EOR and EOF 
marks that currently exist. The cEOR and cEOF reformatting directives are not 
affected. 

Reverses the effect of the cPACK directive. Requests the system not to discard 
succeeding internal EOR and EOF marks that currently exist. 

Indicates transparent mode. When encountering this directive during 
reformatting, the system checks the next line of the submit file for an additional 
reformatting directive. If one exists, it is processed and the following line is 
checked. This continues until a line that does not contain a reformatting directive 
is encountered. Transparent mode is then selected and all directives that exist on 
subsequent lines are ignored until an internal EOR or EOF is encountered (not 
cEOR or cEOF). The cPACK and cNOPACK directives determine if the internal 
EOR or EOF will be retained. The line following the internal EOR or EOF mark is 
then checked for a reformatting directive. If one exists, it is processed and the 
following line is checked. All directives are processed until a line that does not 
contain a reformatting directive is encountered. This causes transparent mode to 
be reset unless a cNOTRANS directive was encountered. This process continues 
until either the end of the submit file is reached or a cNOTRANS directive 
following an internal EOR or EOF is encountered. 
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Directive Description 

The cTRANS directive is typically used in conjunction with the cREAD directive. 
This allows the user to copy the contents of an existing file into the submit file at 
the location of the cREAD directive. Because the file is read in transparent 
mode, no check for reformatting directives is attempted until an internal EOR or 
EOF is encountered. The cREAD directive must follow the cTRANS directive and 
must be located before the first succeeding line that is not a reformatting 
directive. Otherwise, transparent mode is selected before the cREAD directive is 
encountered, and the cREAD directive is ignored. 

The cSEQ or cNOSEQ directive in effect before transparent mode is selected has 
no effect upon the submit file or the file being read (cREAD) while transparent 
mode is in effect. However, the cPACK or cNOPACK directive in effect before 
transparent mode is selected remains in effect after it is selected. 

cNOTRANS Reverses the effect of the cTRANS directive and informs the system that the 

submit file is to be examined on a line-by-line basis. All directives encountered in 
the submit file while the cNOTRANS directive is in effect are processed. This 
directive is initially selected by default; it remains in effect until a cTRANS 
directive is encoioitered in the submit file. 

Caution should be observed in the placement of this directive in the submit file. 
If transparent mode is selected, this directive can possibly be ignored unless it 
immediately follows either a cREAD directive in the submit file or an internal 
EOR or EOF mark. 

cREAD,lfn Requests that the system read the contents of the specified file (Ifn) and insert 

that file in place of the cREAD directive in the submit file, during reformatting. 
Reading terminates when an EOF or EOI is encountered on Ifn. If the file to be 
read is not currently a local file, the system automatically attempts a GET and 
then an ATTACH on the file. If the file is not specified in the directive, file 
TAPEl is assumed. If the file specified cannot be found, the message 

NO READ FILE FOUND - Ifn 

is issued to the job dayfile, and the job is terminated. If the read file is found to 
be busy (direct access files only), the message 

READ FILE BUSY - Ifn 

is issued to the job dayfile, and the job is terminated. The file specified by Ifn in 
the cREAD directive is automatically rewound before the read operation, unless 
the NR parameter is specified in the SUBMIT command. In this case, the 
cREWIND directive must precede the cREAD directive in the submit file to 
rewind file Ifn before the read operation begins. NOS returns all files specified in 
cREAD directives befca-e completion of the job. 

If the cPACK directive is in effect at the time of the read, all interna] EOR 
marks are removed. If the cNOPACK directive is in effect, all internal EOR 
marks are read into the submit file in the proper position during reformatting. 

Unless transparent mode is in effect when file Ifn is read, each line of that file is 
also checked for a reformatting directive. Any directives contained in tlie file, 
except another cREAD, are processed. The cREAD directive cannot be nested. In 
addition, any directives in effect before the cREAD directive is processed remain 
in effect for the file being read, unless transparent mode is selected. Then, only 
the cPACK or cNOPACK directives remain in effect for the file being read. 
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Directive Description 

Moreover, only those directives that immediately follow an internal EOR in the 
file being read are processed. If the file to be read is a binary file, it is 
recommended that the cTRANS directive be used. This is to ensure that binary 
data is not mistaken for a reformatting directive. If used, the cTRANS directive 
should immediately precede the cREAD directive in the submit file.' 

cREWIND,lfn Requests that the system rewind file Ifn to BOI. If Ifn is not supplied, file TAPEl 
is assumed. This directive is required only if .the NR parameter is included in the 
SUBMIT command. Otherwise, file Ifn is automatically rewound. 

This directive is used in conjunction with the cREAD directive. Thus, to rewind a 
file before the read operation begins, this directive must precede the cREAD 
directive in the submit file. 

ciEC=C2 Indicates that the escape code character is to be changed from ci (current escape 

code) to C2 (new escape code). The new escape code is used to recognize all 
subsequent reformatting directives until further change. 

No line in a submit file should exceed 150 6-bit characters. The system processes the first 80 characters 
of the line as a batch control statement and discards the final 70 characters, which can be used for 
comments or sequence numbers. These final characters do not appear in the dayf ile messages. If any 
input line exceeds 150 characters, the results are unpredictable. 

Tte following procedure shows how a BASIC program and associated batch control statements are 
reformatted into the structure of a batch job. This batch job is then submitted from the terminal bv 
means of the SUBMIT command. ' 

A BASIC program for generating factorials is entered at the terminal and made into the foUowine 
indirect access permanent file. * 

basic 

READY. 
neWfbasprog 

READY, 
auto 

00100 a=1 
00110 z=15 
00120 for i=1 to z 
00130 a=a»i 

00140 print "factorial"i"="a ^ 
00150 next i 
00160 end 
00170 
•DEL* 
save 

READY. 
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FcH- this program to be submitted as a batch job from a terminal by means of the SUBMIT command a 
submit fUe must include it as part of its coding. This submit file has the batch control statements t'hat 
direct job execution, according to user requirements, as well as any reformatting cfirectives that 
Structure the batch job according to the usa-'s particular specifications. 

This submit file is created and saved as follows: 
new,sbntjob 



READY, 
auto 



00100 /job 



00110 Sjob(t500,cmil0000) 



00120 user(jlc2016,jlc2) 



00130 charge(5923,693n451) 



00140 basic(l=results, 
krresults) 



00150 replace(results) 



Line numbers facilitate modification while the file is being 
created. These line numbers are stripped off during 
reformattii^, unless the user specifies otherwise (NOSEQ). 

The uset has chosen the character / to identify ref wmatting 
directives. The presence of this directive at the be^nnir^ of 
tiic submit file indicate that there are other reformatting 
directives in the file. If the coding is to be used without any 
reformatting, this directive is not necessary. 

This is the job statement required at the beginning of every 
batch job. 500 is the maximum amount of time, in decimal 
seconds, the user allows the central processor to spend on any 
one job step, 40000 is the maximum amount of central 
memory storage, in octal units, the user allows f« each job 
step. Refer to the job statement in the NOS Reference 
Manual, v<dume 1. 

This is the USER statement with user name JLC2016 and 
password JLC2. If the user name or password is incorrect, 
the system logs the user out immediately and decrements the 
security count (refer to section 8) of the user name under 
which he was logged in. Refer to section 8 for informatiwi 
cmcerning restrictions associated with the use of tWs 
statement. 

This is the CHARGE statement with charge number and 
project number. 

This calls the BASIC compiler, initiates execution of the 
object code, and puts the listable compiler output and 
execution output on a file called RESULTS. This is done so 
the output can be printed out at the user's convenience. 

This makes the output a permanent file so that it is not lost 
after job execution. A REPLACE is used instead of a SAVE 
since the user may want to execute this job several times 
with variations. A REPLACE keeps putting the new 
information in place of the old. 
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00160 rewind( input) 



00170 copycf( input, reformt) 
00180 replaoe(reformt) 

00190 dayfile(myday) 

00200 replace(myday) 
00210 exit. 

00220 replace(results) 

00230 dayfile(myday) 
00240 replace(myday) 

00250 /eor 
00260 /noseq 

00270 /read,basprog 
00280 /eof 



File INPUT is rewotmd in preparation for the following 
command. Ordinarily, the pointer in batch input is at the 
beginning of the second record, the program. The user wants 
to copy the entire input file, including the first record of 
control statements. 

The entire batch job as reformatted is copied to- a file called 
REFORMT. 

The reformatted file is made permanent so that it is not lost 
after job execution. The user can then list this file to see 
what the reformatting looks like. A REPLACE is used 
instead of a SAVE to allow future repetitions of this job. 

The job execution history is put on a file called MYDAY. 

The history file is made a permanent file for future reference. 

Normal job processing ends if no errors have t>een en- 
countered. However, if the system encounters any errors in 
the preceding statements, it skips to this statement and then 
executes those that follow. 

If any errors occurred in the BASIC program, they were listed 
on file RESULTS. This statement makes the file permanent, 
for future reference if the job fails. 

The job execution history is put on a file called MYDAY. 

The history file is made a permanent file for future 
reference, if the job fails. 

This reformatting directive causes an end-of -record mark to 
be placed here in the batch job. This signals the end of the 
first record, the control statements. 

This reformatting directive tells the system to leave all line 
numbers that follow this directive when reformatting the 
submit file. This is necessary since the second record is a 
BASIC program which requires line numbers. 

This reformatting directive inserts file BASPROG at this 
point. The system first searches local files and then the 
user's permanent files. 

This final reformatting directive puts an end-of-file mark 
here, indicating the end of the second record and the end of 
the file. It is included in this example only for clarity. 
Because the system automatically writes an end-of-file, the 
directive is not required. 
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To submit this job, the user enters the lAF command 
submitCsbmtjob) 



The file enters the system, and the system immediately assigns it a unique name, consisting of the first 
four letters of the user's index hash followed by three characters which the system derives from its 
internal alphabetical sequencing. lAF then Effints out the time and the name it has assigned. In this case, 



07.51.02.AIDQAGH. 
READY. 



The refwmatting directives are executed, and the resulting file is sent to the batch input queue. 
The user is now interested in: 

• What does the reformatted input look like? 

• What are the results of job execution? 

The answers are on the permanent files REFORMT and RESULTS. However, these files do not exist until 
after job execution. The user can verify completion of job execution by entering the ENQUIRE command 
(section 4), usii^ the last three characters of system-supplied job name AGH to identify the job. 

enquire, Jn=agh 



When the reply is 

AIDQAGH NOT FOUND. 
READY. 

the user knows the job has finished execution. He can then obtain the foUowing two listir^. 
old,reforat 

READY. 
lnh,r 
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This produces the following listing, which includes end-of -record and end-of-file marks. 

SJOB(T500,CMt0000) 

USER(JLC2016, JLC2) 

CHARGE(5923,693N'»51) 

BASIC (L=RESULTS,K=RESULTS) 

REPLACE(RESULTS) 

REWIND(INPUT) 

COPYCF( INPUT, REFORMT) 

REPLACE(REFORMT) 

DAYFILECMYDAY) 

REPLACE(MYDAY) 

EXIT. 

REPLACE(RESULTS) 

DAYEILEi-M-YJlAY) 

REPLACE(MYDAY) 

~EOR~ 

00100 A=1 

00110 Z=15 

00120 FOR 1=1 TO Z 

00130 A=A»I 

00110 PRINT "FACTORIAL"I"="A 

00150 NEXT I 

00160 END 

— EOR — 

— EOF~ 

READY. 
get, results 



READY. 
Inh.frresults 
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This produces the following listii^. 



00100 


A=l 






00110 


Z = 15 






00120 


FOR 1=1 


TO Z 




00130 


A=A«I 






00140 


PRINT " 


FACTORIAL"!": 


:"A 


00150 


NEXT I 






00160 


END 







FACTORIAL 


1 = 


1 


FACTORIAL 


2 s 


2 


FACTORIAL 


3 = 


6 


FACTORIAL 


<t : 


24 


FACTORIAL 


5 = 


120 


FACTORIAL 


6 = 


720 


FACTORIAL 


7 = 


5040 


FACTORIAL 


8 r 


40320 


FACTORIAL 


9 = 


362880 


FACTORIAL 


10 


= 3628800 


FACTORIAL 


11 


= 39916800 


FACTORIAL 


12 


= 479001600 


FACTORIAL 


13 


= 6.22702E+9 


FACTORIAL 


14 


= 8.71783E+10 


FACTORIAL 


15 


= 1.30767E+12 



READY. 



ERROR PROCESSING 

If the user determines that an error occurred during processing of his job, he can reference a listing of 
the job dayfile as an aid in identifying the cause of the error. The job dayfile contains a record of the job 
processing activity and is disposed to the local batch queue or the RBF queue for printing when the job is 
terminated. However, all output is dropped at job termination when a batch job is submitted from a 
time-sharing terminal, unless the B or E option is specified in the SUBMIT command. This includes the 
dayfile output as well as the job output. In this event, the user can make provisions within the job to 
save the contents of the dayfile if an error in processing occurs. This is done by including the following 
control statements at the end of the job control statement record (first record of the submit file). 



EXIT. 

DAYFILE(lfn) 

REPLACEOfn) 



When an error condition occurs during job processing, the system searches the job control statement 
record for an EXIT statement. If an EXIT statement is found, the error condition is cleared and the 
control statements that follow are processed. In this case, the contents of the job dayfile are copied to 
the temporary file specified by Ifn. That file is then saved for future reference. 

If an error does not occur during job processing, the EXIT statement indicates where to terminate normal 
control statement processing. 
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BATCH SUBSYSTEM g 



The batch subsystem extends the capability of the terminal user by allowing him to enter batch control 
statements as well as the lAF commands. The control statements are entered and processed one at a 
time, and all output is returned to the terminal unless otherwise specified. Refer to the NOS Reference 
Manual, volume 1, for a description of the batch control statements available and information concerning 
their use. 

To enter the batch subsystem, the usee types 

BATCH,nnnnn 

nnnnn Initial running field length for subsequent job steps. Entering this value is equivalent 
to entering the RFL.nnnnn control statement. Refer to the NOS Reference Manual, 
volume 1, for further information. If nnnnn is omitted, is assumed. 

The system respondst 

$RFL,nnnnn. 

/ 

nnnnn Specifies field length. 

The user can then enter an lAF command or any valid batch control statement up to 78 characters in 
length. lAF commands cannot be abbreviated under the batch subsystem; the entire command or control 
statement must be entered to be valid. The user can also end each control statement with a period, but 
this is not required since the system automatically terminates each line of batch input with a period. 
However, if comments are included in the control statement, the user is required to enter a terminator 
(either a right parenthesis or a period). If the command or control statement is not valid or is entered 
incorrectly, lAF responds 

ILLEGAL CONTROL CARD. 

Because the processing of certain control statements could enable unauthorized access to dumps of 
privileged areas of memory, thus violating system security, the following control statements are not 
processed if entered individually or as the first statement in a procedure file from an lAF terminal. 

CKP PEC 

DMD RBR 

DM? RESTART 

LBC WBR 

LOG 



tif the batch subsystem is selected automatically by retrieving an indirect access permanent file with 
the OLD command, the field length is not given (and may not be the default value). Refer to the 
description of the SAVE command in section 5 for additional information. 
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L^nn!!*^.!? ^l % ""^^^ •°/"*^'' ?"y "^ ^^^^^ restricted control statements in the previously discussed 
manner, the foUowmg informative message is printed. 

SECURE MEMORY, DUMP DISABLED. 

The control statements listed are processed as from a batch job if they are included in a procedure file 
and are not the first statement (refer to -pname, BEGIN, or CALL command in section 4) 

ST^^ "J ^°^''^'" ^t«^«";f ts ««" ^ entered only if they are in a procedure file. The system must 
read the entire sequence of loader statements (that is, from the initial loader statement to the 
completion statement) before acting on any one of them. Refer to the CYBER Loader Reference Manual 
for further information on loader statements. neierence iwanuai 

All lAF commands for which there is a corresponding batch control statement can be included in a 
procedure file. The remaining lAF commands cannot be included in procedure files. 

The following command allows the user to force the system to process a valid lAF command (ccccccc) 
normally interpreted by the lAF executive, as a control statement. i-ommana iccccccc;, 

X.ccccccc 

For example, to call the BASIC compiler, the user enters 

X,BASIC 
rather than the command 

BASIC 
which changes the subsystem from batch to BASIC. 

* Sl^UTF '"ArrF^^^*'!!.'vW^'"' *^1 "^* TVf ^^ ^^ ^"*'™ command (FORTRAN, FTNTS. BASIC. 
EJ^CUTE, ACCESS, or NUi^L; to call one of the other subsystems. The user can also chanee the 
subsystem unintentionally by entering the OLD command. The OLD command obtains a different 
primary file but may also select the subsystem that was active when the specified file was orieinaUv 
saved (refer to the description of the SAVE command in section 5). originauy 

I NOTE I 

Although a user can enter any batch control 
statement from a lAF terminal, the output 
produced by several of these statements is 
fwmatted for transmission to a line printer (137 
characters per line). Through use of the L072 
control statement, the user can format the output 
for transmission to an lAF terminal (72 to 150 
characters per line). Refer to the description of 
the L072 control statement in the NOS Reference 
Manual, volume 1. 
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The lAF user should be extremely cautious in using the USER control statement to specify a different 
user name, password, and family name. For security reasons, some sites do not permit an lAF user to 
enter a USER statement, unconditionally logging out any user attempting to do so. At all sites an 
mvalid user name m a USER statement causes the system to log out the user and decrease the security 
count of the user name under which he was logged in. The security count is the maximum number of 
security violations (such as attempting to use an invalid user name) that a user is allowed. A security 
count is assigned to each user name by site personnel. If the user name has exhausted its security count 
the associated user is denied all access to the operating system until the security count is reset bv site ' 
personnel. •' 

When the USER statement is allowed, all permanent file accesses are performed under the user name 
specified in the most recently entered USER statement, in accordance with the file limits and validations 
applicable to that user. However, all job-related restrictions (charge required, memory limits, time 
limits, and so on) remain those of the user specified during login. 



60455250 C » , 



PAPER TAPE OPERATIONS 



GENERAL DESCRIPTION 

Paper tape is used for preparing input off-line (when time is not charged) and entering it on-line (when 
time is charged). This ensures accuracy and speed when most needed. An input tape can include 
programs, data, and commands. Accordingly, it is possible for the entire terminal operation, after login, 
to t>e run from paper tape. 



TELETYPEWRITER 

This discussion assumes a typical teletypewriter (model 33) with a paper tape punch and a paper tape 
reader. 

The paper tape punch has four buttons with the following labels and use. 



Button 

ON 

OFF 

REL. 

B.SP. 



Description 

Turns the punch on. 

Turns the punch off. 

Releases the feedwheel so one can freely move the tape through the pu.ch head. 

Backspaces the tape one row of holes each time it is pressed. This is used to make 
corrections when preparing a tape off-line (refer to Corrections in this section). 



The paper tape reader has one switch with four positions. Position labels and use are as follows: 



Position 
START 

STOP 
AUTO 

FREE 



Description 

Starts the reader. After switch is momentarily held in this position, it snaps back 
to the AUTO position and reading continues. 

Immediately stops reading. 

This position is used in conjunction with the input and processing of commands and 
data in tape mode (refer to Tape Mode in this section). It allows the tape reader 
to be turned off and on so that processing of each command or line of data can be 
completed before additional input is entered. 

Releases the feedwheel so user can freely slide the tape in and out of the read 
head. 



NOTE 



On teletypewriters lacking an AUTO position, 
reading must be manually restarted each time it 
has been stopped. 
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CONTROL CHARACTERS 

Each line of input from paper tape must end with a particular sequence of control characters. These are 
punched by functional keys on the teletypewriter keyboard. The control characters used with paper tape 
are as follows: 

Character Description 

@ Message terminator. This is the RETURN key on the model 33. It moves the 

print head to the beginning of the line and informs lAF that this line of input 
is completed. 

LF Line feed. This is the LINE FEED key on the keyboard. It advances the paper 

roller one line. In normal mode, lAF sends a signal that initiates this feed; in 
tape mode, this signal is not sent and is therefore required on tape. 

CTRL/X-OFF X-off. The appearance of this character on the tape during reading turns the 

tape reader off. This character is punched by holding down the CTRL key and 
pressing the X-OFF key. 

RO(n) Rubout. This is the RUB OUT key on the keyboard. It punches a full row of 

holes. This row is interpreted as null by the system, and hence this character 
is used for spacing and overpunching errors. The n parameter specifies the 
minimum number of times this character should be punched in sequence. 



INPUT LINES 

The following line formats are used to enter programs, data, and commands. The left half of the page 
shows an example of the input; the right half of the page shows the control characters that immediately 
follow the last input character. Each line is terminated with three rubouts to provide separation from 
the next line. While it is possible that adequate separation is provided with less than three rubouts, this 
is the recommended number. (lAF punches three rubouts at the end of each line when a tape is produced 
on-line.)' 

PROGRAM LINE 

100 PROGRAM TEST (INPUT.OUTPUT) @ LF RO(3) 

DATA LINE 

? 12.44,18.31,29.08 @ LF CTRL/X-OFF R0(3) 

(The ? is supplied by lAF. The remainder of the line comes from the tape. X-OFF turns 
the reader off to allow this data to be processed before the next line is read.) 

COMMAND LINE 

CATLIST,LO=F % LF CTRL/X-OFF R0(3) 

(X-OFF turns the reader off to allow p'ocossing of the command to be completed before 
thi; next line is read.) 



T Input lines are blank-padded to an even number of characters. 
9-2 
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PUNCHING A TAPE OFF-LINE 

The following procedure is used to punch a tape when the teletypewriter terminal is not logged in. 

1. Place the teletypewriter in local mode. 

2. Turn the paper tape punch on by pressing the ON button located on the punch. 

3. Prepare a tape leader of about 30 rubouts (3 inches) either by simultaneously pressing the RUB 
OUT and REFT keys or, if the terminal has the capability, by punching blank tape. 

4. With a pencil, trace the arrow above the punch output onto the tape. This identifies the start of 
the tape for reading. (It is possible to put the tape in the reader backwards.) 

5. Type in the input lines with their appropriate control characters. 
6i Add a 3-inch trailer of rubouts or blank tape and tear the tape off. 
7. Turn the teletypewriter off. 

TAPE MODE 

To read and process data and commands from tape, it is necessary that the tape reader be turned off, to 
allow time for processing, then be restarted. By entering tape mode, the user enables lAF to synchronize 
tape input with its processing. 

The user enters tape mode by using the TRMDEF command (section 4) or a terminal definition command 
(appendix F) to change the input device to a paper tape reader. To do this with the TRMDEF command, 
the user enters 

TRMDEF,IN=PT 

To perform the same operation with a terminal definition command, the user presses the ESC keyt 
(assuming a model 33 teletypewriter is being used) and enters 

IN=PT 

The TRMDEF command can specify the input device to be in character mode (PT or KB) only; to specify 
the input device is in transparent input mode (XP, XK, or X), a terminal definition command must be 
used. For all other paper tape operations, the TRMDEF command and terminal definition commands can 
be used interchangeably. The remainder of this section will use the TRMDEF command in examples. 

The network acknowledges entry into tape mode by positioning the carriage to the beginning of the line 
and then performing one or two line feeds. If the reader switch is in the AUTO position, reading begins 
automatically; if the reader switch is in the OFF position, reading does not begin until it is manually 
initiated by momentarily moving the switch to START. 



tThe ESC key is the default control character for terminal class 1. It must be pressed to signal the 
entry of a terminal definition command. Because the control character differs for some terminals, 
refer to appendix F for the default values for all terminal classes. 
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The user exits from tape mode by using the TRMDEF command or a terminal definition command to 
change the input device back to the keyboard. This can be dwie with TRMDEF by entering 

TRMDEF,IN=KB 

The paper tape punch can also be defined as the output device using the TRMDEF command or a terminal 
definition command. This can be done by entering 

TRMDEF,OP=PT 

The user specifies this command to enter tape mode for outputting information to paper tape. This mode 
S.^iI?^V ^^°^^ ^"^^"^ characters when punching the tape. The user exits this mode by using the 
TRMDEF command or a terminal definiti(»i command to change the output device back to a printer. This 
can be done by entering 

TRMDEF,OP=PR 

PUNCHING A TAPE ON-LINE 

To punch a tape with infOTmation already contained in a system file, the following procedure is used. 
1. If not logged in, log in. 
I 2. If not in tape mode, enter TRMDEF,OP=PT. 

Type in LIST if the primary file is to be punched; type in LIST,F=lfn if a local file other than the 
primary file is to be punched. Do not press® . (The LNH command is permissible.) 

4. Turn the punch on. 

5. Run a leader of rubouts or blank tape. 

6. Press@. The file is listed and punched simultaneously. The network adds the aporoDriate 
control characters at the end of each line. 

7. Run a trailer of rubouts or blank tape. 



3. 



CORRECTIONS 

?Qp" ^Jlf'""^ Ml^ °^k;""®J °o'''"«ctions can be made by backspacing over the incorrect punch (use the 
B^F. button on the punch) and punching a rubout over the error (use the RUB OUT key on the keyboard). 
Then punch in the correct character. 

ft is also p<Bsible to make corrections by using the backspace key as in normal, on-line operation. 
However, the error and/or any overtyping appear in the printout. When line numbers are being used an 
^^r^" "^ ''^" ^ retyped (and repunched) with the same line number. Although the erronlous and 
c«n^t versions appear m the printout. lAF retains only the last occurrence of thi specific numbered 
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Example: 

The foUowing is the tape as punched. The left half of the page shows the printed copy produced as the 
Sui'tSS' "^* ^""^ °^ *** ^^ """" **^ contrrcharacters entered at tS S?of eac^line 



100 LET FACTOR =1 

no INPUT N 

120 FOR 1=1 TO N 

130 LET FACTOR=FACTOR«I 

110 PRINT FACTOR 

150 NEXT I 

160 END 



RCKSO) 



@ LF R0(3) 

@ LF R0(3) 

@ LF R0(3) 

@ LF R0(3) 

@ LF RO(3) 

@ LF R0{3) 

@ LF RO(30) 



rL^cm^r7K-"r ""^ "ZZ "' "I." "'^^' " "* «*»»"'"«" ine user is lo^ed in under the nuU subsystem. He 
positions this tape m the reader and sets the reader switch to AUTO. The following is the printout that 

exSatlTs of'tl^ aS°" "'"'' ""' *"'" ""' *'" *"""'""'• '^' "^'^^ '^^^ °^ ^^ page coSs 



basic -*- 
READY. 



. new, fact 1 -*■ 



trmdef ,in=pt-*- 



100 LET FACTORsI 

110 INPUT N 

120 FOR 1=1 TO N 

130 LET FACTOR=FACTOR»I 

140 PRINT FACTOR 

150 NEXT I 

160 END 



- By typing this command, the user enters 
the BASIC subsystem. 

■ The user types in this line to establish a 
new primary file with the name FACTl. 

■ As soon as this command is typed in and 
the @ takes effect, the tape reader goes 
on and the entire tape (seven lines) is 
read in. The reader runs through the 
trailer of rubouts and then turns itself 
off. 



READY, 
trmdef ,in=kb- 

READY. 



The user changes the input device back 
to the keyboard. 
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rnh-*- 



ILLEGAL STATEMENT AT 100 
ILLEGAL STATEMENT AT 130 
ILLEGAL STATEMENT AT 140 
BASIC COMPILATION ERRORS 



The user types in RNH and receives the 
diagnostics shown. BASIC variables 
cannot be more than two characters. 



100 let f=1-.- 
130 let f=f»i 
140 print f 

rnh « 



? 5 

1 
2 

6 

24 

120 



The user types in the corrective coding 
shown. 

The user initiates another run with the 
RNH command. lAF replies with ? He 
types in 5 and receives the desired 
pri ntou t. 



RUN COHPLETE. 



trader ,op=pt<«- 



READY. 
Inh 








100 


LET F: 


:1 






110 


INPUT 


N 






120 


FOR I: 


=1 


TO 


N 


130 


LET F: 


:F* 


n 




140 


PRINT 


F 






150 


NEXT I 






160 


END 









READY. 



The user wants to punch a new tape 
containing this corrected program. He 
enters tape mode and then types LNH 
but does not press @. He turns on the 
punch, runs off some leader, and then 
enters@. As lAF prints the listing, it 
also punches a tape with the same 
information and the control characters 
@ , carriage return idle fill, LP, LF idle 
fill, and NUL(3) at the end of each line. 
The carriage return idle fiU and LF idle 
fill vary with the terminal class and can 
be set with the CI and LI terminal 
definition commands. After this, the 
user punches a trailer of rubouts and 
tears off the new tape. He discards the 
original tape. 
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Example: 

In this example, the input tape contains not only a program but also the commands to execute, modify, 
list, and save that program and the input data used by that program. 

The following is the complete tape as punched. The left half of the page gives the printed copy produced 
as the tape is punched; the right half of the page shows the control characters entered at the end of each 
line but not printed. 



FTNTS 

NEW, DEMO 

100 PROGRAM DEMO( INPUT, OUTPUT) 

DIMENSION 11(5) 

READ 10, (II(J),J=1,5) 

10 FORMAT(5I5) 

PRINT 20, (II(J),J=1,5) 

20_FORMAT(5I10) 

Enu 



110 

120 

130 

1l«0 

150 

160 

RNH 

1111 12222233333'* '♦'I4455555 

SAVE,DEM0=TAPE1 

135 DO 1 1=1,5 

137 II(I) = II(I)+'*4i|4 

139 1 CONTINUE 

RESEQ, 100,5 

LNH 

RNH 

1111 12222233333'»'»'»'»'»55555 

REPLACE, DEM0=TAPE1 



RO(30) 
@ LP 

@LF 
@ LP 

@ LP 
@> LF 

@LF 
@ LF 

@LF 
@ LF 

@LF 
@ LP 

@LF 
@ LF 

@LF 

@LF 
@^LF 

@LF 
@ LF 

@LF 



CTRL/X-OFF 


R0(3) 


CTRL/X-OFP 


R0(3) 


RO(3) 




RCKS) 




R0(3) 




RCKS) 




R0(3) 




RO(3) 




R0(3) 




CTRL/X-OFF 


RO(3) 


CTRL/X-OFF 


RO(3) 


CTRL/X-OFF 


R0(3) 


R0(3) 




R0(3) 




R0(3) 




CTRL/X-OFF 


RO(3) 


CTRL/X-OFF 


R0(3) 


CTRL/X-OFF 


R0(3) 


CTRL/X-OFF 


R0(3) 


CTRL/X-OFF 


RO(30) 



To execute this tape, the user logs in to lAF, positions the tape in the reader, sets the reader switch to 
AUTO, types the command TRMDEF,IN=PT and, upon pressing @ , starts the reading of the tape He 
then observes the remainder of the action without intervention. 
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The following is the printout of the execution of the tape, 
explanations of the acticffi. 



The right half of the page contains 



FINIS-*- 



NEW, DEMO- 



100 
110 
120 
130 
140 
150 
160 
RNH 



PROGRAM DEMO( INPUT, OUIPUI)-*- 

DIMENSION 11(5) 

READ 10, (ritJ),J=1,5) 

10 FORMAT(5I5) 

PRINT 20, (II(J),J=1,5) 

20 F0RMAT(5I10) 

END 



? 111112222233333'»1HU455555 -^ 



11111 



22222 



END 

SRU 0.130 UHTS. 
RUN COMPLETE 

SAVE , DEMOrTA PE 1 -*— 



33333 



44444 



135 DO 1 1=1,5-^ 



137 II(I)=II(I)+4444 
139 1 CONTINUE 



RESEQ, 100,5-" 

SRU 0.576 UNTS. 



-When this line is read, the reader stops. 
As soon as FTNTS is established as the 
current subsystem, lAF turns the reader 
back on. 

- When this line is read, the reader stops. 
After a new primary file called DEMO is 
established, lAF turns the reader back on. 

-The seven lines of the program are read 
without interruption. 



■ After the command to run the program is 
read, the reader is turned off. 

' After processing reaches the READ 
statement (line 120) and after lAF prints 
?, lAF turns the reader on, and the line 
of data is read. Then the reader is 
turned off to aUow data [»*ocessing. 

Resulting (x-intout: 
55555 



■ After the SAVE command is read, the 
reader is turned off. A copy of the 
program DEMO is made an indirect 
access permanent file with the name 
TAPEl. Then the reader is turned back 
oi. 

■ These three lines of modification are 
read in from the tape without 
interruption. 

• After the RESEQ command is read, the 
reader is turned off. When resequencing 
is accomplished according to 
specifications, the reader is turned back 
on. 
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LNH-. , 

00100 PROGRAM DEMO(INPUT. OUTPUT) 

00105 DIMENSION 11(5) 

00110 READ 10, (II(J),J=i,5) 

00115 10 FORMAT(5I5) 

00120 DO 1 1=1,5 

00125 II(I) = II(I)+4iti4i4 

00130 1 CONTINUE 

00135 PRINT 20, (II(J ) , J=i ,5) 

00140 20 F0RMAT(5I10) 

00145 END 



After the LNH command is read from 
tape, the tape reader is turned off. Then 
lAF lists the primary file which contains 
the above modifications in resequettced 
fwrnat. When the listing is completed, 
the reader is turned on again. 



RNH-^ 



1111122222333334444455555 



After the RNH command is read in, the 
reader is turned off, and the modified 
program is executed. lAF prints the ? 
and then turns the reader on. The line of 
data is read in from the tape and the 
reader turned off. The data is "recessed 
and results printed. '^ — —vv. 



END 



15555 



26666 



37777 



48886 



59999 



SRU 1.185 UNTS. 
Rim COMPLETE 



REPLACE, DEMOrTAPEI^ 



• This last command is read In and the 
reader turned off. A copy of this revised 
version of DEMO replaces the old one 
that was made an indirect access 
permanent file under the name TAPEl. 
It is now the indirect access permanent 
file that is referenced by the name 
TAPEl. 

The reader is turned back on. It runs 
through the trailer of rubouts and then 
turns itself off. 

If, at this point, the user has no more 
tapes to run, he should exit tape mode by 
entering the TRMDEF,IN=KB command. 
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CHARACTER SETS AND CODE SETS 



INTRODUCTION 

A Character set is composed of graphic characters and/or control characters. A code set is composed of 
the codes that represent each character within a character set. 

A graphic character may be displayed at a terminal or printed by a line printer. Examples are the 
characters A throu^ Z and the digits 1 through 9. A control character initiates, modifies, or stops a 
control operatiOT. An example is the backspace character that moves the terminal carriage or cursor 
back one space. Althou^ a control character is not a graphic character, a terminal may produce, a 
graptric representation when it receive 

AU references within this manual to the ASCH character set or the ASCH code set refer to the character 
set and code set defined in the American Natiwial Standard Code for Information Interchange (ASCII 
ANSI Standard X3.4-1977). References in this manual to the ASCH character set refer to the characters 
defined by ASCII; references are not necessarily to the coded representations of these characters. 



CHARACTER SETS 

NOS supports the foUowir^ character sets. 

• ASCn graphic 64- or 63-character set. 

• ASCII 128-character set. 

• ASCn graphic 95-character set. 

• CDC graphic 64- or 63-character set. 

The first two sets are of most importance to the time-sharing user. The last two sets are used only in 
batch operations. The user selects the ASCH graphic 64- or 63-character set with the NORMAL 
command and the 128-character set with the ASCII command. (The CSET command can also be used to 
select the character set.) The 64- or 63-character set is assumed unless the user specifies otherwise. 

Each site selects either the 64-character set or the 63-character set. The differences between the two 
are described under Character Set Anomalies in this appendix. Any further reference to the 
64-character set implies either the 63- or 64-character set unless otherwise stated. 

CODE SETS 

NOS supports the following code sets. 

• Display code. 

• 6/12 display code. 

• 12-bit ASCn code. 

Display code is a set of 6-bit codes from 003 to 770 
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The 6/12 display code is a combination of 6-bit codes and 12-bit codes. The 6-bit codes are 00 g through 
778, excluding 748 ^n^ ^Sg (refer to Character Set Anomalies for the interpretation of the OOs and BSg 
codes). The 12-bit codes begin with either 748 o"" 768 ^nd are followed by a 6-bit code. Thus, 748 ^^^ 
768 are considered escape codes and are never used as 6-bit codes within the 6/12 display code set. The 
12-bit codes are 7401, 7402, 7404, 7407, and 76018 through 76778. All other 12-bit codes (74xx8 and 
76008) are undefined. 

The 12-bit ASCII code is the ASCII 7-bit code (as defined by ANSI Standard X3.4-1977) right-justified in a 
12-bit byte. Assuming that the bits are numbered from the right starting with 0, bits through 6 contain 
the ASCII code, bits 7 through 10 contain zeros, and bit 11 distinguishes the 12-bit ASCII OOOOg code 
from the end-of-line byte. The 12-bit codes are OOOlg through 01778 and 40008. 



CHARACTER SET ANOMALIES 

When an installatioi selects the 63-character set rather than the 64-character set, NOS interprets two 
codes differently. The codes are for the colon ^nd percent graphic characters. Tables A-1 and A-2 show 
the codes for both 63- and 64-charaeter sets. The codes for the colon and percent graphic characters in 
the 64-character set are unshaded. The codes for the colon and percent graphic characters in the 
63-character set are shaded. 

When in time-sharing ASCII mode at a 64-character set site, the colon is translated to 6/12 display code 
74048 on input; on output, the occurrence of the 74048 code results in the printing of a colon. The 6/12 
display code 00 is not defined on input; however, the occurrence of the 6/12 display code 00 on output at 
a 64-character set site results in the printing of a colon (the colon is always 638 on input and output at a 
63-eharacter set site). 

When using either the 63- or 64-character set, the use of undefined 6/12 display codes in output files 
produces unpredictable results and should be avoided. Also, two OOg codes may be confused with an 
end-of-line byte and should be avoided. 



CHARACTER SET TABLES 

Table A-1 shows the character sets and code sets available to an ASCII code terminal user. The user 
selects the ASCn graphic 64-character set with the NORMAL command. The characters available in 
normal mode are listed in the column labeled ASCII Graphic (64 Char). The coded representations for the 
characters are listed in the column labeled Display Code. 

The user selects the ASCII 128-character set with the ASCII command. The characters available in 
ASCn mode are listed in the column labeled ASCD Character (128 Char). The coded representations for 
these characters are listed in the column labeled 6/12 Display Code. 

The character set tables are designed so that the user can find the character represented by a code (such 
as in a dump) or find the code that represents a character. To find the character represented by a code, 
the user looks up the code in the column listing the appropriate code set and then finds the character on 
the line in the column listing the appropriate character set. To find the code that represents a 
character, the user looks up the character and then finds the code on the same line in the appropriate 
column. 

The time-sharing user can convert a 6/12 display code file to a 12-bit ASCII code file using the batch 
control statement FCOPY (refer to the NOS Reference Manual, volume 1). The resulting 12-bit ASCII 
file can be routed to a line printer twt cannot be output at a time-sharing terminal. 

Table A-2 gives the octal and hexadecimal ASCD codes for characters. This is useful for commands such 
as TRMDEF which can specify a character in either octal or hexadecimal ASCII code. 
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TABLE A-1. TIME-SHARING CHARACTER SETS 



ASCII 


ASCII 




6/12 


12-Bit 


ASCII 


ASCII 




6/12 


12-Bit 


Graphic 


Character 


Display 


Display 


ASCII 


Graphic 


Character 


Display 


Display 


ASCII 


(64 Char) 


(128 Char) 


Code 


Code 


Code 


(64 Char) 


(128 Char) 


Code 


Code 


Code 


: colon t 




oot 






# num. sign 


num. sign 


60 


60 


0043 


Wi9fiH^ <SO*S 


m 1» mEte:£Hic<i 3«: «it»9 wfii^ t^ * 


C 1. bracket 


C 1 . bracket 


61 


61 


0133 


$3-%1a«3r««£«t 


*«t. 


■: 




3 r. bracket 


3 r. bracket 


62 


62 


0135 


A 


A 


01 


01 


0101 


Zt 


Xt 


63t 


63t 


0045 


B 


B 


02 


02 


0102 


t colon 


: tacilba 


m 


«3 

64 


tmt 


C 


C 


03 


03 


0103 


" quote 


" quotp 


64 


0042 


D 


D 


04 


04 


0104 


_ underline 


underl ine. 


65 


65 


0137 


E 


E 


05 


05 


0105 


! 


1 


66 


66 


0041 


F 


F 


06 


06 


0106 


& ampersand 


& ampersand 


67 


67 


0046 


G 


G 


07 


07 


0107 






















■ apostro4>he 


' apostroi^e 


70 


70 


0047 












1 


7 


71 


71 


0077 


H 


H 


10 


10 


0110 


< 


< 


72 


72 


0074 


I 


I 


11 


11 


0111 


> 


> 


73 


73 


0076 


J 


J 


12 


12 


0112 


a 




74 






K 


K 


13 


13 


0113 


\ rev. slant 


\ rev. slant 


75 


75 


0134 


L 


L 


14 


14 


0114 


circumflex 




76 






n 


n 


15 


15 


0115 


; semicolon 


; semicolon 


77 


77 


0073 


N 


N 


16 


16 


0116 


















17 


17 


0117 




S 

c'ircumflex 
: colon t 




7401 
7402 
7404T 


0100 
0136 
0072 


p 


P 


20 


20 


0120 


WMMMM&S;{V'ik 


mmmmmimm 


^ 


mmmi 


ii^ifl 


Q 


a 


21 


21 


0121 




grave accent 




7407 


0140 


R 


R 


22 


22 


0122 












S 


s 


23 


23 


0123 




a 




7601 


0141 


T 


T 


24 


24 


0124 




b 




7602 


0142 


U 


u 


25 


25 


0125 




c 




7603 


0143 


V 


V 


26 


26 


0126 




d 




7604 


0144 


U 


w 


27 


27 


0127 




e 
f 




7605 
7606 


0145 
0146 


X 


X 


30 


30 


0130 




g 




7607 


0147 


Y 


Y 


31 


31 


0131 












z 


z 


32 


32 


0132 




h 




7610 


0150 








33 


33 


0060 




i 




7611 


0151 


1 


1 


34 


34 


0061 




J 




7612 


0152 


2 


2 


35 


35 


0062 




k 




7613 


0153 


3 


3 


36 


36 


0063 




I 




7614 


0154 


4 


4 


37 


37 


0064 




m 
n 






7615 
7616 
7617 


0155 
0156 
0157 


5 


5 


40 


40 


0065 












6 


6 


41 


41 


0066 




P 




7620 


0160 


7 


7 


42 


42 


0067 




q 




7621 


0161 


8 


8 


43 


43 


0070 




r 




7622 


0162 


9 


9 


44 


44 


0071 




s 




7623 


0163 


+ 


+ 


45 


45 


0053 




t 




7624 


0164 


- 


- 


46 


46 


0055 




u 




7625 


0165 


* 


* 


47 


47 


0052 




V 

u 




7626 
7627 


0166 
0167 


1 


/ 


50 


50 


0057 




X 




7630 


0170 


( 


( 


51 


51 


0050 




y 




7631 


0171 


) 


) 


52 


52 


0051 




z 




7632 


0172 


S 


S 


53 


53 


0044 




f left brace 




7633 


0173 


= 


- 


54 


54 


0075 




1 vert, line 




7634 


0174 


space 


space 


55 


55 


0040 




} right brace 




7635 


0175 


, comma 


, comma 


56 


56 


0054 




- tilde 




7636 


0176 


. period 


. period 


57 


57 


0056 




DEL 




7637 


0177 


t The interpr 
elsewhere i 


Btation of this 
n this appendix 


characte 


r or code 


may depe 


nd on i ts cont 


pxt. Refer to f 


haracter 


Set Anom 
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TABLE A-1. TIME-SHARING CHARACTER SETS (Contd) 



ASCII 

Graphic 

(64 Char) 


ASCII 
Character 
(128 Char) 


Display 
Code 


6/12 

Display 

Code 


12-Bit 
ASCII 
Code 


ASCII 

Graphic 

(64 Char) 


ASCII 
Character 
(128 Char) 


Displ ay 
Code 


6/12 

Display 

Code 


12-Bit 
ASCII 
Code 




NUL 
SOH 
STX 
ETX 
EOT 
ENQ 
ACK 
BEL 




7640 ■ 

7641 

7642 

7643 

7644 

7645 

7646 

7647 


4000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 




OLE 
DCI 
.DC2 
DC3 
DC4 
HAK 
SYN 
ETB 




7660 
7661 
7662 
7663 
7664 
7665 
7666 
7667 


0020 
0021 
0022 
002 3 
0024 
002 5 
0026 
0027 




BS 
HT 
LF 
VT 




7650 
7651 
7652 
7653 


OOIO 
0011 
0012 
0013 




CAN 

EM 

SUB 




7670 
7671 
7672 


0030 
0031 
0032 




FF 
CR 




7654 
7655 


0014 
' 0015 




FS 
GS 
RS 
US 




7674 


UUJJ 

0034 




SO 
SI 




7656 
7657 


0016 
0017 






7675 
7676 
7677 


0035 
0036 
0037 










— -1 1 _J 

79AAIA 
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TABLE A-2. ASCII TO 6/12 DISPLAY CODE CONVERSION 



ASCII 
Character 
(128 Char) 


12-Bit 
ASCII Code 


6/12 

Display 

Code 


ASCir 
Character. 
(128 Char) 


12-Bit 
ASCII Code 


6/12 

Display 

Code 


Octal 


Hex 


Octal 


Hex 


NUL - 


4000 


00 


7640 





0060 


30 


. 33 


SOH 


0001 


01 


7641 


1 


0061 


31 


34 


STX 


0002 


02 


7642 


2 


0062 


32 


35 


ETX 


0003 


03 


7643 


3 


0063 


33 


36 


EOT 


0004 


04 


7644 


4 


0064 


34 


37 


ENQ 


0005 


05 


7645 


5 


0065 


35 


40 


ACK 


0006 


06 


7646 


6 


0066 


36 


41 


BEL 


0007 


07 


7647 


7 


0067 


37 


42 


BS 


0010 


08 


7650 


8 


0070 


38 


43 


HT 


0011 


09 


7651 


9 


0071 


39 


44 


LF 


0012 


OA 


7652 


: colon t 


0072 


3A 


7404 1 


^ 


0013 


OB 


7653 


t «ot««i 


. mh 


3*. 


«J 


FF 


0014 


OC 


7654 


; semicolon 


0073 


3B 


77 


CR 


OOIS 


00 


7655 


< 


0074 


3C 


72 


SO 


0016 


OE 


7656 


= 


0075 


3D 


54 


SI 


0017 


OF 


7657 


> 


0076 


3E 


73 










7 . 


0077 


3F 


71 


DLE 


0020 


10 


7660 










DCl 


0021 


11 


7661 


a 


0100 


40 


7401 


DC2 


0022 


12 


7662 


A 


0101 


41 


01 


DC3 


0023 


13 


7663 


B 


0102 


42 


02 


DC4 


0024 


14 


7664 


C 


0103 


43 


03. 


NAR 


0025 


15 


7665 


D 


0104 


44 


04 ■ 


SYN 


0026 


16 


7666 


E 


0105 


45 


05 


ETB 


0027 


17 


7667 


F 


0106 


46 


06 










G 


0107 


47 


07 


CAN 


0030 


18 


7670 










EM 


0031 


19 


7671 


H 


Olio 


48 


10 


SUB 


0032 


lA 


7672 


I 


0111 


49 


11 


ESC 


0033 


IB 


7673 


J 


0112 


4A 


12 


FS 


0034 


IC 


7674 


K 


0113 


4B 


13 


GS 


0035 


ID 


7675 


L 


0114 


4C 


14 


RS 


0036 


IE 


7676 


M 


0115 


4D 


15 


US 


0037 


IF 


7677 


N 


0116 


4E 


16 













0117 


4F 


17 


space 


0040 


20 


55 










! 


0041 


21 


66 


P 


0120 


50 


• 20 


" quote 


0042 


22 


64 


Q 


0121 


51 


21 


U number sign 


0043 


23 


60 


R 


0122 


52 


22 


S 


0044 


24 


53 


S 


0123 


53 


23 


% t 


0045 


25 


63 + 


T 


0124 


54 


24 


^ «- ^ " ^ ^ 


ti»«5 : 


S^ 


7*04 , 


U 


0125 


55 


25 


& ampersand 


0046 


26 


67 


V 


0126 


56 


26 


' apostrophe 


0047 


27 


70 


W 


0127 


57 


27 


( 


0050 


28 


51 


X 


0130 


58 


30 


) 


0051 


29 


52 


Y 


0131 


59 


31 


* 


0052 


2A 


47 


I 


0132 


5A 


32 


+ 


0053 


2B 


45 


C left bracket 


0133 


5B 


61 


, comma 


0054 


2C 


56 


\ reverse slant 


0134 


5C 


75 


"* 


0055 


2D 


46 


3 right bracket 


0135 


5D 


62 


. period 


0056 


2E 


57 


circumflex 


0136 


5E 


7402 


/ 


0057 


2F 


50 


_ under 1 ine 


0137 


5F 


65 


t The interpretation 


of this chara 


cter or code may 


depend on its context. 
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TABLE A-2. ASCII TO 6/12 DISPLAY CODE CONVERSION (Cwitd) 



ASCII 
Character 
(128 Char) 


12- 
ASCII 


Sit 
Code 


6/12 

Display 

Code 


ASCII 
Character . 
(128 Char) 


12-Bit 
ASCII Code 


6/12 

Display 

Code 


Octal 


Hex 


Octal 


Hex 


■ 


grave accent 


0140 


60 


7407 


P 


0160 


70 


7620 


a 




0141 


61 


7601 


q 


0161 


71 


7621 


b 




0142 


62 


7602 


r 


0162 


72 


7622 


c 




0143 


63 


7603 


s 


0163 


73 


7623 


d 




0144 


64 


7604 


t 


0164 


74 


7624 


e 




0145 


65 


7605 


u 


0165 


75 


7625 


f 




0146 


66 


7606 


V 


0166 


76 


7626 


g 




0147 


67 


7607 


w 


■0167 


77 


7627 


h 




0150 


68 


7610 


X 


0170 


78 


7630 


i 




0151 


69 


7611 


y 


0171 


79 


7631 


j 




0152 


6A 


7612 


z 


0172 


7A 


7632 


k 




0153 


6B 


7613 


i left brace 


0173 


7B 


7633 


I 




0154 


6C 


7614 


1 vertical line 


0174 


7C 


7634 


m 




0155 


6D 


7615 


> right hrace 


0175 


7D 


7635 


n 




0156 


6E 


7615 


" tilde 


0176 


7E 


7636 







0157 


6F 


7617 


DEL 


0177 


7F 


7637 
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PREVIOUS TIME-SHARING CHARACTER SETS 

Character sets other than those already described in this appendix were used with previous time-sharing 
systems. The user can convert files from one character set to another using the CONVERT command. 

The format of the command is 

C0NVERT,pi,p2,...,Pn 
Pi can be any of the following in any order. 

Pi Description 

P=lfni Input on file Ifni; if omitted, the file named OLD is assumed. 

N=lfn2 Output on file lfn2; if omitted, the file named NEW is assumed. 

RS=n Maximum record size in characters, where n is 1 to 500. If omitted, 

assumed maximum record size is 300 characters. 

64 Converts 63-character set to 64-character set. If omitted, no 63- or 

64-character set conversion takes place (TS must be specified if 64 is 
not). 

TS=t Converts old time-sharing record (61-character set) to new time-sharing 

record (63- or 64-character set)t. t may be one of the following 
terminal types. 

t Terminal Type 

TTY t t ASCn code terminal with standard print 

CORt t Correspondence code terminal with standard print 

CORAPLt t Correspondence code tCTminal with APL print 

MEMAPLt t Memorex 1240 (ASCII code) terminal with APL 

print 

BLKEDTt t Block transmission (ASCII code) terminal with 

standard print 

NAMIAF Virtual network terminal 

If t is omitted, it is assumed to be TTY. If TS is omitted, no 
time-sharing conversion takes place (64 must be specified if TS is not). 



t Old time-sharing character set refers to the 61-character set used by preceding systems (for example, 
early versions of KRONOS 2,1). 
t t These parameters are provided for compatability with previous time-sharir^ systems. 

60455250 C ^_7 



M. 



R 



RC=n 



NM 



Description 

Rewinds input and output files prior to processing. If omitted, no 
rewinding occurs. 

Converts n decimal records. If n is omitted, convert to EOF. If RC is 
omitted, ccmverts one record. 

Used in conjunction with TS parameter and specifies that conversion is to 
normal mode; if omitted, conversion is to ASCII mode. Conversion has 
the indicated effect on the following characters. 



A (circumflex) 



:vcoion; 



If TS is specified, display code 70 
(circumflex character) is converted to 76. If 
NM is omitted, conversion s to 7402 (ASCII 
mode). 

If TS and 64 are specified, display code 63 
(colon character) is converted to 00. If NM 
is omitted, conversion is to 7404 (ASCII 
mode). 



The following conversions are possible as indicated by the legal choice of parameters: 



Type of Record 

63-character set, non-time-sharing 
record 



Old time-sharing recca^ 

New normal time-sharing record 
New ASCII time-sharing record 



Legal Conversion 



64 




CONVERT command error messages are listed in appendix B. 



CENTRAL MEMORY CHARACTER EQUIVALENTS FOR DATA INPUT 

The manner in which characters entered from the terminal are interpreted by the system depends on 
whether the user has specified that the characters belong to the full ASCII set (refer to the ASCII 
command in section 4). For example, if the user enters the following characters: 

aAbBcCdDeE 

to be mapped into the full ASCII set (128 characters recognized), the central memory equivalent (in 
display code) is j -^ \ 



59 


53 


47 


41 


35 


29 


23 

76 


17 


11 


5 


76 


01 


01 


76 


02 


02 


03 


03 


76 


04 


04 


76 


05 


05 


55 


00 


00 


00 


00 



^-^Bit position (60-bit 
central memory word) 
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However, if the characters are mapped into the subset of the ASCII character set used during normal 
operation (64 characters recognized), the central memory equivalent (in display code) is 



59 


53 


47 


41 


35 


29 


23 


17 


11 


5 


01 


01 


02 


02 


03 


03 


04 


04 


05 


05 



Characters entered under transparent input mode (refer to the DL and IN terminal definition parameters 
in appendix F) are not translated into display code. It makes no difference if the ASCII command is in 
effect (128 characters recognized) or if the characters are entered during normal operation (64 
characters recognized). However, the system weights each 8-bit character by 40008 ^"^ places ?; 0007g 
control byte at the beginning of the data. The parity selection (parity switch on the terminal and the PA 
terminal definition parameter) also has an effect on transparent input. If parity (PA) is set to even or 
odd, the network checks 8 bits of each character entered for parity (performing error processing, if 
needed) and sBts the eighth bit to zero before sending the data to lAF. If PA is set to zero, the network 
automatically sets the eighth bit to zero without checking parity. If PA is set to none, all 8 bits are sent 
to lAF exactly as entered. 

For example, if the user of an ASCII code terminal with the parity switch set to even and PA set to even 
enters the following characters in transparent input mode 

aAbBcCdDeE 
the central memory equivalent is 



59 


47 


35 


23 




11 







0007 


4141 


4101 


4142 


4102 


4143 


4103 


4144 


4104 


4145 


4105 


0000 


0000 


0000 


0000 



The characters illustrated are entered from an ASCII code terminal, although any other supported 
terminal code can also be used. 
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TERMINAL MESSAGES B 



This appendix contains an alphabetical listing of messages of importance to the lAF user. (A list of 
dayfile messages can be found in appendix B of the NOS Reference Manual, volume 1.) Each message is 
foUowed by an explanation of the message and/or the circumstances causing it to be issued the 
recommended action, and the routine which issued the message. 

Lowercase letters are used within a message to identify variable fields. All messages beginning with 
lowercase (variable) fields follow those beginning with A through Z. These messages are then 
alphabetized according to the first nonvariable field. 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



APPLICATION TAILED. 



The application has ceased functioning and 
the user can no longer access it. 



Access another 
application or log off 
and try later. 



NETVAL 



APPLICATION NOT PRESENT. 



The requested application is currently not 
available for use. 



Enter the name of 
another application or 
log off and try later. 



NETVAL 



APPLICATION RETRY LIMIT. 



Four unsuccessful attempts were made to 
enter a legal application name, after which 
the terminal was disconnected. 



Ensure the accuracy of 
the entry. If problems 
persist, contact 
installation personnel. 



NETVAL 



ARGOMEMT ERROR. 



BUFFER ARG. ERROR. 



A control statement is syntactically 
incorrect. Refer to the appropriate 
control statement or command for further 
information. 

When the system processes tape management 
statements. It Issues this message if both 
ring enforcement options (PO-R and PO-W) or 
more than one EOT option (PO-I, PO-P, and 
PO-S) is specified. Also, specification of 
duplicate parameters (more than one occur- 
rence of a keyword) or multiple equivalent 
parameters (such as KT/NT, CB/CK, Fl/L, R/W, 
and so forth) is not allowed on tape assignt- 
ment control statements. 

The address parameter on DMFECS, DMDECS, 
LBC, LOC, PBC, or WBR must be numeric. 

CM address in call is not less than the 
field length minus the word count; buffer 
extends past the job's field length. 



Recheck parameters. 



Verify that operation 
does not reference 
address beyond end of 
buffer or job's field 
length. 



CONVERT, 

COPY, 

COPTfBR, 

COPYBF, 

COPYEI, 

COPYX, 

CFHEM, 

L072, 

RESEX, 

TCOPY, 

UPHOD 



TCS 



CATALOG OVERFLOW - FILES, AX addr- 



The number of files in the user's catalog 
exceeds his limit. 



One or more permanent 
files must be purged in 
order to save or define 
additional files. 



PFM 



MESSAGE 



SIGNIFICANCE 



ACTION 



BOnriNE 



CATALOG OVERFLOW - SIZE AT addr. 



The cumulative size of the indirect access 
fllea In the user's catalog exceeds his 

llBlt. 



One or more Indirect 
access files must be 
purged or shortened to 
allow additional 
permanent file space. 



PFH 



CCL100-SEPARATOR FOLLOWING VERB MUST BE 
COMMA OR LEFT PARENTHESIS 



Fatal user error. Separator following verb 
In a CCL statement must be a comma or a 
left parenthesis. 



Change separator 
following verb to a 
comma or a left 
parenthesis. 



CCL 



CCL 101 -LAST NON-BLANK CHARACTIS MOST BE 
SEPARATOR 



Fatal user error. Last character string 
of card or line was not followed by a 
separator or a terminator. 



To terminate statement, 
make last nonblank 
character a period or 
right parenthesis. To 
continue statement on 
next card or line, make 
last nonblank character 
a valid separator. 



CCL 



CCL103-STATEMnrr INCOMPLETE 



Fatal user error. A terminator was 
detected immediately following a verb. 



Check statement format 
(refer to section 4 of 
NOS Reference Manual, 
volume 1 ) and rewrite 
statement, using a comma 
or left parenthesis 
after verb. 



CCL 



CCL200-PROCEDURE NESTING LEVEL 
EXCEEDED 



Fatal user error. Current procedure call 
forced procedure nesting to exceed limit of 
XX, which is defined by installation. 



Reposition procedure 
call statements so limit 
XX Is not exceeded. 



CCL 



CCL201 -PROCEDURE NAME MORE THAN 7 
CHARACTERS 



Fatal user error. Procedure 
greater than 7 characters. 



name canmit be Rename procedure. 



CCL 



CCL203-PROCEDURE FILE NAME HOT SPECIFIED OR 
INVALID 



Fatal user error with following causes. 

- File name specified on BEGIN statement 
was greater than 40 characters. 

- pfile parameter on BEGIN statement was 
null, indicating default file name.. CCL 
was Installed with default file flag 
turned off; no default file name ie 
allowed. 



- Specify a file name 
with 40 or fewer 
characters. 

- Specify a file 



CCL 



MESSAGE 



SIGNIFICAKCE 



ACTION 



ROUTINE 



CCL204-MULTIPLE EQDIVALENCE SPECIFICATIONS 
FOR XX 



Nonfatal user error. A format keyword has 
been specified more than once on procedure 
call statement. Last definition prevails. 



If first specification 
is desired, remove 
second specification. 
If second specification 
is desired, no action 
is required. 



CCL 



CCL205-FOBMAL PARAMETER LIST DOES NOT 
INCLUDE -X 



Fatal user error. While in equivalence 
mode, CCL discovered a formal keyword x on 
procedure call statement that was not 
specified on header statement. 



Remove formal keyword x 
from procedure call 
statement . 



CCL 



CCL206-SyMBOLIC SPECIFICATION INVALID xxx+ 



CCL207-PROCEDURE NAMED BEGIN IS INVALID 



Fatal user error. A parameter, xxx, on 
procedure call statement is followed by a 
plus sign. Plus sign indicates that CCL is 
to convert value to display code, and is 
valid only when preceded by a symbolic name 
and followed by a D, B, or a null field. 
(Example: R1+B is a legal value, but 37+Rl 
is not.) 



Fatal user error, 
named BEGIN. 



A procedure must not be 



If plus sign Is part of CCL 

a character string, 

$-delimit character 

string. If plus sign 

should convert a 

symbolic name to display 

code, replace xxx with a 

valid symbolic name. 

Refer to section 4 of 

NOS Reference Manual, 

volume I for a list of 

valid symbolic names. 

Select another procedure CCL 
name. 



CCL2 11 -SPECIFICATION EXCEEDS XX CHARACTERS 



Fatal user error. Value on a procedure 
call statement or default value on a 
procedure header statement is greater than 
XX characters, xx is defined by 
installation. 



Specify a value with xx 
or fewer characters. 



CCL 



CCL212-SEPARAT0R INVALID strng s 



O 



Fatal user error, s is Illegal separator 
and strng Is character string that precedes 
s. Any of following conditions produces 
this error. 

- On a procedure call statement, the 
separator preceding a formal keyword or 
a poaltlonally specified value Is not a 
comma. 

- Invalid separiator Is part of a character 
string. If a valid separator 
immediately precedes illegal separator 
s, the string is null. 

- #DATA or #FILE has been specified on the 
procedure call statement. 



- Change separator 8 to 
a comma. 

- $-delimit character 
string. 

- Remove IDATA or #FILE 
from procedure call 
statement and specify 
on procedure header 
statement. 



CCL 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



O 



CCL230-PBOCESURE FILE NOT FOUND 



Fatal user arror. No local file was found 
with file name Indicated on BEGIN statement. 
Automatic retrieval of a permanent file with 
that name was inhibited. 



Check file name for 
errors and correct. If 
name is correct, 
retrieve file prior to 
BEGIN statement. 



CCL 



CCL23 I -PROCEDURE NOT FOUND 



Fatal user error. Local or permanent file 
Indicated on BEGIN statement was found, but 
CCL could not find procedure on the file. 



Check procedure name for 
errors and correct. If 
name is correct, check 
file for procedure. 



CCL 



CCL235-FORMAL PARAMETER GT xx CHARACTERS 



Fatal user error. Number of characters In 
a formal keyword on header statement 
exceeds xx, as defined by. installation. 



Define a formal keyword 
with XX or fewer 
characters. 



CCL 



CCL237-SEPARATOR FOLLOWING SECOND DEFAULT 
IS •/• 



Fatal user error. In form fk-defaultl/ 
default2/ on procedure header statement, 
second / is illegal. 



If / is part of 
default2, $-delimit 
character string. If 
not, either remove it or 
replace it with a comma 
or period. 



CCL 



CCL238-F0itMAL PARAMETER LIMIT xx EXCEEDED 



Fatal user error. Number of formal 
parameters on procedure header statement 
has exceeded xx, as defined by installation. 



Remove formal parameters 
from procedure header 
statement until xx or 
fewer parameters remain. 



CCL 



CCL239-PROCEDURE HEADER NOT TERMINATED 



Fatal user error. Procedure header 
statement was not terminated by a period, 
and no control stat^ents were found after 
header statement. 



Terminate header 
statement with a period, 
and add at least one 
control statement to 
procedure. 



CCL 



00 






MESSAGE 



SIGNIFICANCE 



ACTION 



BOUTIIIE 



CCL252-PIIOCEDUM COHTAIMS NO CONTROL 
STATEMHTTS 



Informative oesssge. A procedure should 
contain at least one control statement. 



None. 



CCL 



CHARGE ABORTED. 



Dayflle message Indicating that a central 
site operator action caused the CHARGE 
operation to abnormally terminate. 



Reenter CHARGE statement. 



CHARGE 



CHARGE FILE BUSY. 



Dayflle message Indicating that the file 
which the system uses to validate charge 
numbers and project numbers Is busy. 



Reenter CHARGE statement. 



CHARGE 



CHARGE ILLEGAL AT THIS HOUR. 



Dayflle message Indicating that the 
specified project number cannot be used at 
this time of day. 



Retry during the time the 
project number is valid. 



CHARGE 



CHARGE NIJMBER EXPIRED. 



Dayflle and output file message Indicating 
the charge number expiration date has 
occurred. 



None. 



CHARGE 



CHARGE NUMBER REQUIRED. 



Charge number and project number are re- 
quired to complete login sequence. 



Enter CHARGE command 
with appropriate charge 
and project numbers. 



CHARGE 



COMMAND NOT UNIQUE. 



The characters entered do not uniquely 
specify a command. 



Ensure accuracy of entry. 
Enter a sufficient number 
of characters to specify 
a unique command. 



lAFEX 



COMMAND TOO LONG. 



A command longer than 80 characters was 
entered . 



Reenter using a shorter 
version of the command. 



lAFEX 



CONFLICTING PARAMETERS. 



Input queue type entered more than once. 



Reenter with correct 
parameters. 



SUBMIT 



CONNECTION PROHIBITED. TRY LATER. 



The network Is configured so that only one 
user with a given user name and family name 
can access the requested application at one 
time. 



Request a different 
application or log off 
and try later. 



HETVAL 



O 



MESSAGE 



SIGNIFICANCE 



ACTION 



KOiniKB 



o 



CONNECTION REJECTED. 



The requested application Is already 
servicing the maximum number of terminals. 



Request a different 
application or log off 
and try later. 



NETVAL 



CONTROL STATEMENT LIMIT. 



The user has entered too many control 
statements. 



Reduce the number of 
control statements to a 
value within the 
specified limit. Refer 
to LIMITS command. 



TCS 



CONVERSION NOT FOUND. 



The specified TS conversion table was not 
found. 



Refer to description of 
CONVERT command for 
valid TS options. 



CONVERT 



CONVERSION NOT SPECIFIED. 



Neither the TS nor 64 parameter was speci- 
fied on the CONVERT control statement. 



Correct error and retry. 



CONVERT 



CUMDLATIVE LIMIT EXCEEDED. 



Dayfile and output file message indicating 
that one of the installation-defined 
resource usage accumulators for this project 
exceeded the maximum allowed. The system 
does not update these accumulators in 
FROFILa. Each installation must provide 
this capability if desired. 



None. 



CHARGE 



CUMULATIVE SRU LIMIT EXCEEDED. 



Dayfile and output file message indicating 
that accumulated SRDs have exceeded the 
maximum allowed. 



None. 



CHARGE 



DATA BASE ERROR. 



Dayfile message indicating that the system 
has detected an error in Its validation 
file. 



Contact Installation 
personnel. 



CHARGE, 
MODVAL 



-DEBUG-CARBAGE IN ZZZZZDS FILE. 



File ZZZZZDS contains information other 
than the suspended Job of the current 
session. Retrieval of debug Information 
from session is impossible. 



Return file ZZZZZDS 
and restart debug 
session. 



DEBUG 



? 



MESSAGE 



DEBUG-ILLEGAL PARAMETER-p. 



SIGNIFICANCE 



User specified an illegal parameter on 
DEBUG command. The three parameters 
allowed are ON, OFF, or RESUME. 



ACTION 



Reenter DEBUG conaand 
with correct paraaeter. 



ROUTINE 



DEBUG 



DEBUG-ONLY ONE PARAMETER ALLOWED. 



User entered more than one parameter on 
the DEBUG command. 



Reenter DEBUG command 
with correct parameter. 



DEBUG 



-DEBUG-ZZZZZDS PILE NOT FOUND. 



User did not suspend the debug session 
during the current terminal session. 
Refer to the SUSPEND command (CYBER 
Interactive Debug Version 1 Reference 
Manual) . 



Restart debug session. 



DEBUG 



DEVICE UNAVAILABLE. AT addr. 



Access to the permanent file device 
requested is not possible. User may have 
attempted to access files on a device not 
present in the alternate system. 



Determine that device can 
be made available by 
system operator and 
retry. 



PFM 



DIRECT ACCESS DEVICE ERROR, AT addr. 



EMPTY CATALOG. 



The file specified already exists on a 
device other than the device requested or an 
illegal device type was specified. The 
device on which the file resides may not 
contain direct access files because of one 
of the following reasons. 

- The device is not specified as a direct 
access device In the catalog descriptor 
table. 

- The device is not specified as ON and 
Initialized in the catalog descriptor 
table. 

- The device is a dedicated Indirect 
access permanent file device. 

If on an alternate system, the user's master 
device may not have been transferred to that 
system. 

No entries are present in the catalog. 



Specify correct device 
type. 



PFM 



None. 



CATLIST, 
NDA 



O 



MESSAGE 



SIGNIFICANCE 



ACTION 



KOUTINE 



EOF ENCOONTERED BEFORE TEKMINATION. 



O 



An end-of-£lle was encountered on a CONVERT 
Input file before the specified record 
count was reached. 



Ensure accuracy of 
input file. 



CONVERT 



BOI ENCOONTERED BEFORE TERMINATION. 



An end-of-infomation was encountered on a 
CONVERT input file before the specified 
record count was reached. 



Ensure accuracy of 
input file. 



CONVERT 



ERR.. 



While entering a terminal definition 
connand, the user siiade a format error or 
entered a comniand which is Invalid for his 
tenalnal type or not supported at hta 
Installation. 



Correct format. If 
format is correct, 
check validity of 
command for this 
terminal type. 



CCP 



ERROR IN ARGUMENT. 



One of the following. 

- The pfn is blank or fn - Ifn. 

- The user specified no arguments or a 
blank argument. 

- The user specified too many files. 

- The user entered an illegal parameter. 



Reenter the command or 
control statement with 
correct parameters. 



PFILES 



ERROR IN FILE CATEGORY. 



The user specified an illegal file 
category- 



Refer to description of PFILES, 
file categories for PURGALL 

valid entry. 



ERROR IN LIMITS ARGUMENT. 



Dayflle message indicating that parameters 
were included on the LIMITS statement. 



Enter LIMITS, without 
additional parameters. 



HODVAL 



ERROR IN MODE. 



Permanent file mode specified was not 
recognized. 



Refer to description of 
permanent file modes for 
valid entry. 



PFILES 



ERROR IN PASSWOR ARGUMENTS. 



PASSWOR control statement or command 
parameters are Incorrect. 



Correct control 
statement or command 
and reenter. 



PASSWOR, 
MODVAL 



7 



MESSAGE 



SIGNIFICANCE 



ACTIOS 



ROUTINE 



EKBOR IN T8MDEF ARGUMENT. 



One or more parameters specified in the 
TRMDEF command/statement were In error. 



Ensure that parameters 
are In correct format 
and new values are 
legal . 



TRMDEF 



EXCHANGE PACKAGE /MEMORY DUM? (M FILE 
ZZZDUNP. 



The exchange package and memory dump Is 
written on local file ZZZDUMP because 
the Job Is of time-sharing origin and file 
OUTPUT Is assigned to a terminal. 



To examine the exchange 
package and dump, list 
file ZZZDUMP. 



CPMEM 



EXECUTE ONLY FILE. 



The permanent file accessed can only be 
executed and cannot be read, written, or 
listed. 



Ensure accuracy of entry. 



lAFEX 



FILE NAME CONFLICT. 



Either the user tried to process two files 
having the same name or he specified a 
reserved file name. 



Correct the control 
statement so all files 
have a unique name. 



CONVERT, 

FCOPY, 

TCOPY, 

COPY, 

VERIFY, 

LIBGEN. 

UPMOD 



FILE NAME ERROR. 



File name contains illegal characters or 
contains more than seven characters. 



Ensure that legal file 
name is specified. 



LFH, 

LIBGEN, 
LISTLB 



FILE NAME ERROR, AT addr. 



File name contains Illegal characters. 



Verify that file name 
contains only valid 
characters . 



PFM 



FILE NAME HISSING. 



A file name must be specified before a 
listing containing the permit Information 
can be obtained with a CATLIST command. 



Specify file name with 
FN parameter. 



CATLIST 



FILE NOT SORTED. 



Primary file has one or more lines without 
line numbers. 



Enter PACK or NOSORT 
command or use SORT 
command to obtain more 
detailed diagnostics. 



lAFEX 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



KILE TOO LONG, AT addr. 



The local file specified for a SAVE, REPLACE, 
or APPEND command exceeds the length allowed 
or the direct access file specified for an 
ATTACH operation in WRITE, MODIFY, or APPEND 
mode exceeds the direct access file length 
limit for vhich the user is validated. 



Reduce length of file 
or save as a direct 
access file. 



PFM 



FILE TOO LONG TO SORT. 



Primary file is too long to be sorted 
automatically. 



Enter SORT command to 
obtain more detailed 
diagnostics. 



UFEX 



FL TOO SHORT FOR PROGRAM. 



The user's field length is too short i:or 
the program. 



Rerun the Job with larger TCS, 
field length speclfica- lAJ 
tlon. 



FR INVALID FOR THIS OPTION. 



User entered a string parameter with the 
I option. 



Reenter DAYFILE co 
mand with correct 
parameter. 



DAYFILE 



FROM LOP. ..message 



The message was sent by the local operator. 



If necessary, the user 
can respond using the 
MS command. 



CS 



ILLEGAL APPLICATION, TRY AGAIN. 



The requested application is unknown or 
unavailable to the user. 



Ensure the accuracy of 
the entry. If problems 
persist, contact 
Installation personnel 
concerning validations. 



NETVAL 



ILLEGAL CHARGE. 



Dayflle and output file message indicating 
one of the following. 

- The charge or project number does not 
exist . 

- The project number is not available to 
a user with this user number. 

- ITie charge or project number exists 
but is Inactive. 



Check to see that charge 
and project numbers are 
correct and reenter. 



CHARGE 



a 



f 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ILLEGAL COMMAND. 



The user entered an Illegal command or a 
coBinand he was not validated to use. 



Correct command and 
reenter . 



lAFEX 



ILLEGAL CCmiBOL CAM. 



ILLEGAL DEVICE REQUEST. 



One of the following has occurred. 

- The control statement could not be 
Identified. 

- The USER control statement does not 
have a user number specified. 

- An invalid parameter was specified or 
no terminator was detected. 

- The user Included too many parameters 
on the program call statement (such 
as LGO). 

- The user submitted a control statement 
that he was not validated to use (for 
example, the use of FASSWOR by user not 
validated to change password) . 

- The user submitted a control statement 
that Is Illegal for a particular Job 
type or file type (for example, the 
use of a FAMILY statement in a 
nonsystem origin Job). 

The auxiliary device specified by the FN 
(pack name) parameter does not match the 
device type specified by the R (residency) 
parameter, or the number of units specified 
by the R parameter does not agree with the 
actual number of units available for that 
device type. 



Ensure accuracy and/or 
suitability of control 
statement. 



TCS, 

CHARGE, 

CONFIG, 

HODVAL, 

RESEX, 

EXU, 

FASSWOR, 

026 



Ensure that devices 
specified by FN and R 
parameters are of same 
type, or number of units 
specified matches number 
of units available. 



PFM 



ILLEGAL JOB ORIGIN TYPE FOR TRMDEF. 



The TRMOEF control statement was entered 
from a Job that was not of time-sharing 
origin. 



Retry from a time- 
sharing origin Job. 



TRMDEF 



ILLEGAL LIST OPTION. 



The list option specified in a CATLIST 
command is illegal. 



Refer to description of 
CATLIST command for 
valid list options. 



CATLIST 



ILLEGAL PARAMETER. 



One of the following. 

- Parameter value is outside legal bounds. 

- The user specified a parameter that 
cannot be included on the command or 
control statement. 

- Command/control statement is invalid. 



Ensure accuracy of com- 
mand/control statement. 



lAFEX, 

LISTLB, 

CATLIST 



MESSAGE 



SIGNIFICANCE 



ACTION 



BODTINE 



ILLEGAL PASSUOKD. 



O 



One of the followlag> 

- The password entered Is greater than 
seven characters or contains an invalid 
character • 

- In the PASSWOR command either an 
Incorrect old password was specified or 
the new password was unacceptable;. 

- In the MODVAL control statement (for a 
create or update run) the password for a 
new user contained fewer characters than 
the minimum length required by the site. 
If entered from a K display, the line of 
Input Is Ignored; otherwise, that par- 
ticular user number is disregarded. 



Correct error and 
retry. 



PASSWOR, 

MODVAL, 

PFILES 



ILLEGAL C^EOE SPECiriED. 



Queue type specified is Illegal- 



Retry with valid queue 
type. 



SUBMIT 



ILLEGAL TERMINAL CLASS CHANGE ATTEMPTED. 



The TC parameter in the THMDEF command/ 
statement requested a terminal class that 
was Illegal for the terminal being used. 



Change TC parameter 
value to a value 
acceptable for the 
terminal . 



TRMDEF 



ILLEGAL TERMINAL TYPE FOR TRMDEF. 



The TRMDEF command/statement was entered 
from a terminal that was not a network 
terminal. 



Retry from a network 
terminal. 



TRMDEF 



ILLEGAL USER. 



Four unsuccessful attempts at login were 
made after which the terminal was 
disconnected from the system. 



Obtain accurate login 
information before 
attempting to log in. 
Inform site analyst If 
problem persists. 



NETVAL 



ILLEGAL USER ACCESS. 



The user tried to perform an operation for 
which he is not validated. Possible causes 
Include attempts to 

- run a system origin job from nonsyetem 
origin 

- access a restricted subsystem without 
proper validation 



Ensure accuracy of LFH, 

control statement or NETVAL, 

determine proper vali- QFSP, 

datlon requirements RESEX, 

via LIMITS statement. 1HA 



? 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



enter an Invalid SRU value 

use the V carriage control character 

without validation 



ILLEGAL USER ACCESS, AT addr. 



The user Is not validated to create direct 
access or indirect access files or to access 
auxiliary devices* 



Contact Installation 
personnel concerning 
validations* 



PFM 



ILLEGAL USER ACCESS - CONTACT SITE OPR. 



The security count for the user number 
specified has been decremented to zero* 
Therefore, the user is denied all access 
to the operating system until the operator 
resets the security count* 



Inform site operator* 



CPM, 
NETVAL, 
lAJ, 
ILS 



IMPROPER LOGIN. TRY AGAIN. 



The family name, user number, or password 
is not acceptable as entered* 



Ensure accuracy of 
entries and/or accuracy 
of information* 



METVAL 



INCORRECTLY FORMATTH) DATA. 



A terminal definition parameter specified on 
the TRMDEF command or via the 0016 control 
byte was not correct* 



Ensure accuracy of entry 
and retry* 



U7EX 



INPUT RESUMED* 



The system overload condition has cleared* 



Resume terminal input* 



CCP 



INPUT STOPPED message* 



Because of a system overload condition, the 
network cannot accept terminal input* The 
message field is an installation-defined 
text string* 



Walt until the message 
INPUT RESUMED is Issued 
before proceeding* 



CCP 



*INVALID ENTRY, TRY AGAIN* 



The user entered incorrect characters. 



Enter correct char- 
acters* 



lAFEX 



INVALID TERMINAL NUMBER. 



The terminal number entered by the user 
during an attempted recovery contained a 
format error or size error. 



Retry using corrected 
terminal number. 



UFEX 



O 



MESSAGE 



SIGNIFICANCE 



ACTION 



BODTIHE 



a 
O 



JOB ACTIVE. 



The system Is unable to process the command 
because the previous command has not: com- 
pleted. 



Retry when current 
operation Is complete. 



lAFEX 



JOB STEP EXCEEDS ACCOUNT BLOCK. 



The user tried to set his job step limit to 
a value greater than his account block 
limit or tried to set his account block 
limit to a value less than his Job step 
limit. 



Check values on SETJSL 
and SETASL statements. 



CPM 



LINE NUMBER LIMIT EXCEEDED. 



The line number encountered or required 
during a resequenclng (RESEQ) operation 
exceeded 99999. 



Examine program and 
correct line number in 
error. 



RESEQ 



LOCAL FILE LIMIT. 



The user has too many local files. 



Return one or more local LFM, 
files and retry. QFM 



LOGIN ABORTED, TRY LATER. 



Insufficient resources are available to allow 
the user to gain access to the network. 



None. 



NETVAL 



MESSAGE LIMIT. 



The number of messages the Job Issued 
has exceeded the limit for which the user 
is validated. Message functions issued by 
compilers or applications programs that 
run at the user's Job control point are 
also counted as user dayflle messages and 
thus are subject to the user's validated 
dayflle message limit. 



Split Job Into two or 
more Jobs and retry. 



lAJ, 
IMA 



MODVAL ABORTED. 



The terminal user was prevented from 
changing his password because the installa- 
tion was updating the validation flla or 
another user was modifying his password. 



Retry operation at a 
later time. 



MODVAL 



NO CONNECT TIME AVAILABLE. 



Dayflle message indicating that the user has 
accumulated the maximim connect time allowed 
for the specified project number. 



Contact installation 
personnel in order to 
Increase maximum connect 
time allowed. 



CHAKCE 



I 



7 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



HO CPU TIME AVAILABU. 



Dayflle message indicating that the user has 
accumulated the maximum CPU time allowed 
for the specified project number- 



Contact installation 
personnel in order to 
Increase maximum CPU 
time allowed. 



CHASGE 



NO FILE FOUND - fllanam. 



The file specified in the READ directive of 
a submit file could not be found. 



Ensure that the 
specified file exists. 



SUBMIT 



NO PRIMARY FILE. 



The command entered requires a primary 
file. 



Establish a primary file 
with NEW, OLD, or PRIMARY 
command and reenter 
original command. 



lAFEX 



NO READ FILE POUND - filenam. 



The file specified on the /READ directive 
cannot be found. 



Ensure that file name 
specified Is correct and 
that the file is a local 
file or a permanent file. 



SUBMIT 



NO SOURCE FILE SPECIFIED. 



No file name was specified on the control 
statoaent call. 



Perform LISTLB to 
determine expiration 
date. 



SUBMIT 



OUTPUT FILE LIMIT. 



The total number of files disposed to the 
output queue by the Job has exceeded the 
limit for which the user is validated. 



If possible, split Job 
into two or more Jobs and 
retry. Otherwise, reduce 
number of files by 
copying output to single 
file and then issuing 
dispose. 



LFM 



OVER. . 



Another page of output exists. 



Enter carriage return 
to view next page of 
output • 



CCP 



PASSWORD TOO SHOUT. 



In the PASSWOR command the new password 
specified contains fewer characters than 
the minimum required. 



Use a longer password. 



PASSWOR, 
MODVAL 



O 



MESSAGE 



PF UTILITY ACTIVE, AT addr. 



SIGNIFICANCE 

Because a permanent file utility is 
currently active, the operation was not 
attempted; the user should retry 
the operation. 



ACTION 



Wait until PF utility Is 
not active and retry. 



ROUTINE 



PFM 



PFM ILLEGAL REqOEST, AT addr. 



One of the following. 

- Illegal command code passed to PFM 

- Illegal permit mode or catalog type 
specified 

- CATLIST request has permit specified 
without a file name 

- PERMIT command or macro attempted on 
public file 



Verify that PFM request 
is valid. 



PFM 



PROCEDURE FILE EMPTY. 



Procedure file specified contains no data. 



Verify that procedure 
file contains data and 
retry. 



CONTROL 



PROJECT NUMBER EXPIRED. 



Dayfile and output file message Indicating 
that the project number expiration date has 
occurred. 



None. 



CHARGE 



PRU LIMIT, AT addr. 



The job's mass storage PRU limit was 
exceeded during preparation of a local copy 
of an Indirect access file. 



Return one or more local 
files and retry. 



pra 



PRUS REC^ESTED UNAVAILABLE. 



No device currently has available the amount 
of space requested by the S parameter. 



If possible, reduce the 
number of PRUs specified 
by the S parameter, or 
retry at another time 
when space might be 
available. 



PFM 



READ FILE BUSY - filenam. 



The read file is found to be busy (direct 
icuess file only) . 



Retry after file Is not 
busy. 



SUBMIT 



RECORD SIZE EXCEEDS 500. 



The maximum line length for a record to be 
converted (500 characters) was exceeded. 



Split lines that are too 
long into two or more 
lines. 



CONVERT 



7 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



RECOVERY IMPOSSIBLE. 



During an attempted recovery, one of the 
following conditions occurred. 

- The system could find no record of the 
specified user being logged In on the 
given terminal number In the past 10 
minutes. 

- Information on the user necessary for 
recovery was Incorrect because of a 
system malfunction. 



None. 



lAFEX 



REPEAT. 



Because of a temporary overload condition. Reenter the 
the network has discarded the last logical Information, 
line of Input. 



CCP, 

NETVAL 



RESEQ NUMERIC PARAM ERROR. 



A parameter which Is supposed to be numeric 
contains a nonnumerlc character. 



Correct error and rerun. 



RESEQ 



RESERVED FILE NAME. 



A reserved file name was Incorrectly used. 



Choose a nonreserved 
file name. 



OPLEDIT, 

EDIT, 

DATADEF, 

DAYFILE, 

IAFE3C 



SECURE MEMORY. DUMP DISABLED. 



An attempt was made to dump memory protected 
by the system. 



None. 



lAJ 



*SRU LIMIT* 

ENTER S TO CONTINUE (« CR KEY TO STOP: 



The user has exceeded his system resource 
unit (SRU) limit during a terminal session 
or job. 



To continue, allocate 
nnnnn additional SRUs 
with S, nnnnn command 
or enter S alone to 
allocate an installa- 
tion-defined number 
of SRUs. 



lAFEX 



SUBMIT FILE BffTY. 



An EOR or EOF was encountered on the submit 
file before any data was found. 



Rewind submit file, 
verify format of data 
and that the file Is a 
local file, and retry 
operation. 



SUBMIT 



o 



MESSAGE 



STSTUI BOS?, PLEASE TRY LATER. 



STSXai CLOSED. 



SYSTEM ERROR. 



TERMINAL BUSY. 



SIGNIFICANCE 



The maximum number of terminals allowed for 
the site are currently active on the system. 

The system Is not available for use by 
terminals . 



A software or hardware system error 
occurred . 



The user attempted to send a message to a 
terminal which was receiving output or had 
an input request outstanding. The message 
was lost. 



ACTION 



ROUTINE 



Try again at a later 
time. 


lAFEX 


None. 


NETVAL, 




UFEX 


Inform site analyst 
Inmediately. 


MODVAL, 
PFM 


Retry operation at a 
later time. 


UFEX 



TERMINAL NOT ACTIVE. 



The user attempted to send a message to an 
inactive terminal. 



None. 



lAFEX 



TERMINAL nnnnn TIME OUT. 



The terminal has been logged off after no 
input was received for several minutes. 
(Limit Is set by installation.) 



Attempt recovery or log 
in again. 



UFEX 



*TIME LIMIT* 

ENTER T TO CONTINUE OR CR KEY TO STOP; 



The monitor detected that the time limit 
for the Job step has expired. 



To continue, reset time 
limit with T, nnnnn 
command or enter T 
alone to set time limit 
to an installation- 
defined default. 



1AJ 



TIMEOUT. 



The user has not responded to a login 
prompt within the system-specified time 
interval (usually ^out 2 minutes) and 
the terminal was disconnected. 



Respond more quickly 
to prcmpts. 



NETVAL 



XL NOT VALIDATED. 



The time limit requested exceeds that for 
which the user is validated. 



Request smaller time 
limit. 



CPM, 
ACCFAM 



OB 



? 



MESSAGE 



SIGNinCANCE 



ACTION 



ROUTINE 



TOO MANY FILES - NOT ALL PROCESSED. 



The Job had more files than could be 
processed. 



If message resulted 
from a REWIND 
operation. Issue a 
series of REWIND 
statements or commands. 
Otherwise, reenter the 
statement or command. 
Inform the site analyst 
If this error occurs 
frequently. 



MFILES 



TOO MANY PARAMETERS. 



More parameters were entered (Including null 
parameters) than are allowed for command. 



Ensure accuracy of entry. 



GTR, 
UFEX 



TBMDEF ERRORS. 



Errors were found In the TRMDEF command/ 
statememt. Additional error messages are 
listed at the terminal or. If the L 
parameter was Included, on the output file 
specified by L. 



Correct error and retry. 



TRMDEF 



TBMDEF PROCESSING COMPLETE. 



The TRMDEF command/statement was processed 
with no errors. 



None. 



TRMDEF 



UNSUPPORTED CODE SET. 



The user attempted automatic recognition of 
a character code set which is not supported 
at his installation. 



Use a supported code 
set. 



CCP 



WRITE ON READ-ONLY FILE Ifn AT addr. 



Either the user attempted to write on a file 
with write Interlock or the direct access 
file was not attached in WRITE mode. 



Reattach file In write 
mode or clear write 
interlock. 



CIO, 
lAFEX 



filenam ALREADY PERMANENT, AT addr. 



The user has already saved or defined a file 
with the name specified. 



Save or define file using 
different file name or 
purge existing file. 



PFM 



pfn BUSY, AT addr. 



o 
O 



The specified direct access file is 
attached in the opposite mode, or it is 
currently being accessed by one of the 
following. 

- More than 77B users in READ mode 

- More than 77B users In READAF mode 

- More than 7777B users in READMD mode 



Reissue ATTACH until file 
becomes available, or 
issue ATTACH specifying 
NA option. 



PFM 



o 



MESSAGE 



SIGNIFICANCE 



ACTION ROUTINE 



Ifn 91PT7, AT addr. 



The file specified on a SAVE request 
contains no data. 



Verify that file contains PFM 
data and retry. 



nnn FIl£(S) PKOCESSED. 



The operation was performed on nnn flies. 



None. 



MFILES 



tc - INVALID PAKAMETER VALUE. 



The value assigned to the terminal 
characteristic parameter specified by 
tc was not legal. 



Correct error and retry. 



TRMDEF 



proc IS A CCL PROCEDURE. 



Procedure specified in CALL statement is a 
CCL procedure. 



Use BEGIN command. 



CONTROL 



f Uenaa NOT FOUND. 



RESTART was unable to retrieve a file named, 
but not included, on fllenam. 



Verify that fllenam is 
valid. 



RESTART 



proc NOT FOUND. 



Procedure specified in CALL statement 
cannot be found. 



Verify that procedure 
name is correct and 
retry. 



CONTROL 



pfn NOT FOUND, AT «ddr. 



One of the following. 

- The specified permanent file could 
not be found. 

- The specified user number could not 
be found. 

- The user is not allowed to access the 
specified file. 

- The user issued an indirect access 
file command on a direct access file. 

- The user issued a direct access file 
command on an indirect access fil*. 

this message occurs in response to the 
SAVE request, the specified local file is 
not attached to the control point. Is a 
direct access file, or is an execute-only 
file. 



Verify that file name/ 
user number is correct, 
that access permission 
has been granted, and 
that correct access Is 
being attempted. 



PFM 



If 



DO 



T 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



flleoaa NOT ON MASS STORAGE, AT addr. 



The file to be saved Is not on mass storage; 
the first track of the file Is not 
recognizable* 



Verify that file Is on 
mass storage* 



PFM 



nnnnn RECORDS CONVERTED. 



Informative message Indicating the number of 
records (nnnnn) converted from one character 
set to another* 



None* 



CONVERT 



GLOSSARY 



Account Block 

Alphanumeric 
APL 

Application 



Application Switching 

ASCII 
Auxiliary Device 

BASIC 

BOI 
Catalog 

Compile 

Control Statement Record 



That portion of an lAF session from login to logout or entry of a 
CHARGE statement which signals a new account block. 

Consisting of alphabetic and/or numeric characters only. 

A programming language. An interactive interpreter available to 
the user. 

A program resident in a host computer that provides an 
information storage, retrieval, and/or processing service to a 
remote user via the network. lAF is an example of an 
application. 

The process of leaving the control of one application and 
entering the control of another, without going through another 
complete login sequence. 

American National Standard Code for Information Interchange; 
the 128-character.set utilized by some terminals and the network. 

Mass storage permanent file device used to supplement storage 
provided by the normal permanent file devices associated with 
the system (refer to family device). 

1. Beginner's all-purpose symbolic instruction code is an 
elementary programming language available to the user. 

2. Subsystem that uses the BASIC compiler. 

Beginning-of-information. 

The list of names of permanent files belonging to a particular 
user name; this list also contains information about the 
permanent files. 

To translate a program from a higher level programming 
language (for example, FORTRAN or BASIC) into machine 
instructions called object code. 

The first, and possibly only, record on an INPUT file or a SUBMIT 
file consisting of statement images that start with a job 
statement and end with the first EOR, EOF, or EOI. 



I 



fit)455250 C 



C-1 



CYBER Record Manager 



Direct Access File 

Display Code 
ECS 



EOF 



EOI 

EOR 

Empty Record 

Family Device 



Field Length 



A software product supported under NOS that allows a variety of 
record types, blocking types, and file organizations to be created 
and read. The execution time input/output of COBOL 4, COBOL 
5, FORTRAN Extended 4, FORTRAN 5, Sort/Merge 4, ALGOL 4, 
BASIC, and DM&-170 products is implemented through CYBER 
Record Manager. The system input/output of NOS is not 
implemented through CYBER Record Manager. All CYBER 
Record Manager file processing requests ultimately pass through 
the operatir^ system input/output routines. COMPASS programs 
can use either CYBER Record Manager or NOS input/output 
(CIO). 

A permanent file that can be attached to the user's job. All 
changes to this file are made on the file itself rather than a 
temporary copy of the file (refer to indirect access file). 

A character code set used to represent alphanumeric and special 
characters (refer to appendix A). 

Extended core storage. An additional memory available as an 
option. This memory can only be used for program and data 
storage, not for program execution. Special hardware 
instructions exist tar transferring data between central memory 
and ECS. 

End-of-file is a boundary within a sequential file but not 
necessarily the end of a file that can be referenced by name. 
The actual end of a named file is defined by an EOI. CYBER 
Record Manager divides files into partitions; therefore, a NOS 
multifile file is a multipartition file. 

End-of-information. 

End-of-record is the terminator of a logical record. 

A PRU that contains no user data (same as zero length PRU); 
indicates the end of a logical record. 

Mass storage permanent file device associated with a specific 
system. A family may consist of 1 to 63 lexical devices. 
Normally, a system runs with one family of permanent file 
devices available. However, additional families may be 
introduced during normal operation. This enables the user 
associated with the additional families to access their permanent 
files via an alternate system. 

Number of central memory words required to process a job. 
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File 



Flag 
FORTRAN 



FTNTS 

Indirect Access File 

Interactive 

Library File 

Line 
Local File 

Local Operator (LOP) 

Locked File 
Login 



Set of information that begins at BOI and ends at EOI and that is 
referred to by a logical file name. This is the only definition of a 
file in CYBER Record Manager and the languages that use 
CYBER Record Manager. In NOS, a file is also defined as that 
portion of a file terminated by EOF;' thus, a multifile file can 
exist. Generally, when a NOS command has a parameter that is 
a file name, that parameter refers to the BOI and EOI 
definition. Files within a multifile file cannot be individually 
referenced by name. When a NOS command has a parameter 
that specifies the number of files, that parameter uses the EOF 
definition. 

A character or bit that signals the occurrence or presence of a 
particular condition. 

1. Formula Translation, a high-level language consisting of 
symbols and statements that can be used to create a 
program closely resembling mathematical notation. 

2. The subsystem that uses the FORTRAN Version 5 compiler. I 

The subsystem that uses the FORTRAN Extended Version 4 
compiler. 



A permanent file that is accessed only by making a temporary 
copy of the file <GET, OLD, or LIBRARY commands). It is 
created or altered by saving or substituting the contents of an 
existing temporary file (REPLACE or SAVE commands). 

Job processing in which the user and the system communicate 
with each other, rather than the user submitting his job and 
receiving output, having no control over the job while processing 
occurs. 

A permanent file residing under the special user name 
LIBRARY. Several other definitions exist (refer to the NOS 
Reference Manual, volume 1.) 

Refer to zero byte terminator. 

Any file that is currently associated with a job. Local files 
include temporary files and attached direct access files. 

The local operator manages the communications elements of the 
network. Local operator functions may be performed at the 
system console, or at a remote terminal. 

A file on which a user cannot write. 

A procedure that must be performed by the terminal user to 
initially establish communication with an application. 
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Logical Record 



Master Device 

Network 

Object Code 

Qn-Line 

Order Dependent 

Order Independent 

Parameter 
Password 



Permanent File 
Permanent File Family 

POTt 

Post Radix 
Prefix Character 
Primary File 



A lexical record on mass storage is terminated by an EOR; on 
tape, it is terminated by the conditions described in the NOS 
Reference Manual, volume 1, for individual tape formats. Often, 
a logical record contains more than one CYBER Record Manager 
record. Because CYBER Record Manner defines a line as a 
logical record, a NOS logical record may contain several record 
manager logical records. 

Mass storage device that contains the user's permanent file 
catalog, all his indirect access files, and all, part, or none of his 
direct access files. 

A data and message switching and routing system used to provide 
communication between terminals and applications. 

Executable machine language instructions. An object code 
program need not be recompiled each time it is executed. 

Equipment under direct control of the computer. 

Items which must appear in a specific order. 

Items which need not be given in any specific order. Parameters, 
particularly those with i<eywords. may be order independent. For 
example, the UN=usernam parameter in the GET command is 
order independent. 

A variable that is given a specific value for a particular purpose 
or process. 

1. A system access word that must be used in addition to the 
user name at login. 

2. A file access word that defines access to a particular file by 
alternate users. 

A file which is created by a user, stored under his user name in 
the permanent file system, and is removed from permanent file 
storage only when specified by a user who has write permission. 

Permanent files which reside on the family devices of a specific 
system. 

The point at which a communication line is attached to the 
computer. 

A letter following a numeral that indicates the base numbering 
system. 

A character that has a special significance to a program or the 
operating system. 

Any temporary file created with the OLD, LIBRARY, PRIMARY, 
or NEW command. The primary file is assumed to be the file on 
which most lAF operations are performed unless another file is 
specified. 
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Private Auxiliary Device 

Procedure File 
PRU 



Pit)lic Auxiliary Device 



Record 



Record Separator 
Record Type 

Recovery 

Rollout File 

Rubout Characters 

Security Count 
Sequence Numbers 



Auxiliary device associated with a specific user. Only that user 
may create files on the device, although he may permit other 
users to access files which reside on the device. 

Under NOS, a file containing control language end control 
statements, but not commands defined only for time-sharing. 

Physical record unit. The amount of information transmitted by 
a single physical operation of a specified device. A PRU for 
mass storage devices is 64 central memory words in length. 
Refer to the NOS Reference Manual, volume 1 or 2, for 
information concerning tape PRU sizes. 

Auxiliary device available for access by all validated users 
knowing the correct pack name. Additional validation is required 
to create or replace files on an auxiliary device (refer to LIMITS 
Command in section 4). 

A unit of information which is interchangeable with logical 
records in NOS. 

In CYBER Record Manager and its language processors, a unit of 
information produced by a single write request. 

In FORTRAN, a formatted write produces zero byte terminated 
recOTds, and an unformatted write produces W type records. 

In NOS, another name for an EOR. 

May have one of several meanings, depending upon its context. 
In CYBER Record Manager, there are seven record tVL>es defined 
by the RT field in the FIT. 

The process by which a terminal user re-establishes 
communication with lAF after an inadvertent disconnection and 
is able to continue processing at the point of disconnection. 

A file containing a job (and system information) that has been 
temporarily removed from the main processing area of the 
system. 

Characters created by pressing the RUB OUT key on the 
terminal. These are considered null input by the system and 
these characters are required in paper tape output. 

The number of security violations the user has left before he is 
denied access to the system. 

The AUTO command adds line numbers at the beginning of each 
line of a file. If a file uses sequence numbers, zero byte 
terminated lines or logical records are implied. 
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Sequential File 



Source Code 
Special Editing 

SRU 

System File 

System Resource Unit (SRU) 

System Utilities 
Temporary File 

Terminal Name 
Terminal Number 
Time Slice (CPU) 
Transparent Mode 



TTY 

User Break 1 Sequence 

User Break 2 Sequence 



A file in which records are accessed in the logical order in which 
they occur. Any file can be accessed sequentially. Sequential 
files must be accessed sequentially because no key or address is 
associated with each record in the files. All CYBER Record 
Mant^er files are considered sequential files by NOS. 

Code input to the computer for later translation into executable 
machine language instructions (object code). 

Mode in which the cancel input character, backspace character, 
and line feed character are not treated as special characters but 
are passed to lAF as input data. 

Refer to System Resource Unit. 

A file that can be accessed only by a system program. 

A unit of measurement of system usage. The number of SRUs 
includes the CPU time, memory usage, and I/O activity. 

System programs used to perform system functions. 

A file created by the user that is not a permanent file, or a copy 
of a file that already exists in the system. All temporary files no 
longer exist once they are returned to the system (either 
specifically or at user l<^out). 

A network-supplied name used to identify the terminal to the 
local operator. 

An lAF-supplied number used by the terminal operator during a 
recovery sequence. 

The amount of CPU time a job is allowed to use before the 
system lowers its priority to allow other jobs to execute. 

Mode in which all characters entered at the terminal are sent to 
lAF as 7-bit codes (or as 8-bit codes, depending on the parity) 
without translation. Normally, characters entered at the 
terminal are translated and stored as 6-bit and/or 12-bit display 
codes. This mode is initiated either with the 0006 control byte 
or with the IN=XK or IN=XP terminal definition commands. In 
former time-sharing systems this mode was referred to as binary 
mode. 

Teletypewriter. 

The character or sequence of characters that causes an 
executing program to be interrupted (also called the interruption 
sequence). 

The character or sequence of characters that causes an 
executing program to be terminated (also called the termination 
sequence). 
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User Name 

Validation File 
Write Interlock 
W Type Record 



XEDIT 



Zero Byte Terminator 



A qrstem access viard that must be supplied by the user for 
validation purposes at login. This is sometimes called the user 
number. 

File containing validation information for all users (user names, 
passwords, resources allowed, and so on). 

Only one person at a time can attach a direct access file in write 
mode. A file that is attached in write mode is in write interlock. 

CYBER Record Mant^er record type in which user data is 
preceded by a system-supplied control word. FORTRAN 
unformatted writes and Sort/Merge use W type records as default 
record types. EOF and partition boundaries are not equivalent on 
files with this type of record. 

The text editor develoD^d hw tho TTni»anoifii «* i>«;— .— *- --j 
available for use on NOS. 

The 12 bits of zero in the low order position of a central memory 
word. Either the zero byte terminator is used to terminate a line 
of coded information listed at the terminal or line printer, or it 
is used to represent cards entered through a card reader. Files 
with names INPUT and OUTPUT have such terminators while in 
storage. Any file to be displayed at a terminal must alw have 
such terminators fw each line to be displayed correctly. A 
record with such a terminator in CYBER Record Manager is a 
zero-toyte record (Z type record). 

The SUBMIT command requires files whose lines are terminated 
with zero bytes. A record (marked by EOR) in NOS may contain 
one or several zero-byte records. 

In display code, two colons create 12 bits of zeros. If two 
consecutive colons occur in a file that contains zero-byte 
records, they may be stored in the lower order portion of a word 
and create a zero-byte record. 

Files created at a terminal using the AUTO or TEXT command or 
by using Text Editor or XEDIT contain zeroHsyte terminated 
records. 



Zero Length PRU/Record 



A PRU that ccHitains no user data. 
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MASS STORAGE DEVICE STATISTICS 



The mass storage devices supported by the system and the 
are as follows: 


size of blocks allocated for 


direct access files 


Device 






Block Size 




Code 


Device 


PRUs 


CM Words 


Characters 


DE 


Extended core storage 


16 


1024 


10 240 


Din 


844-21 disk storage subsystem 
(half track; l<n<8) 


n*107 


n*6848 


n*68 480 


DJn 


844-4X disk stort^e subsystem 
(half track; l<n<8) 


n*227 


n*14 528 


n*145 280 


DKn 


844-21 disk storage subsystem 
(full track; l<n<8) 


n*112 


n*7168 


n*71 680 


DLn 


844-4X disk storage subsystem 
(full track; l<n<8) 


n*227 


n*14 528 


n*145 280 


DMn 


885 disk storage subsystem 
(half track; lSn<3) 


n*640 


n*40 960 


n*409 600 


DP 


Distributive data path 


16 


1024 


10 240 


DQn 


885 disk storage subsystem 


n*640 


n*40 960 


n*409 600 



In this table, n indicates the unit count for multiunit devices and x is 1 or 4. 

If the user's validation permits (refer to UMITS Command, section 4), the maximum size of nn inHin*.,.* 
acce^ me is the device limit less the space allocated for catalog informat™d othe'files 

^£^ ;?£^S^?lSS t^l^^^^^S^ -^ '^ '-^^^' ^y -«^«tion if the file is to be 
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TEXT EDITOR AND XEDIT COMMAND INDEXES 



TEXT EDITOR COMMAND INDEX 

This is a list of the commands available under Text Editor. 
Editor Reference Manual. 

ADD(S) 
ADD(S);n 
ADD(S):/string/ 
ADD(S):/string/;n 

A I iriM 

ALIGN;n 

ALIGN:/strir^/ 

ALIGN:/strir^/;n 

ALIGN:/stringl/,/string2/ 

ALIGN:/stringl/,/string2/;n 

BLANK(S) 

BLANK<S);n 

BLANK(S):/strir^/ 

BLANK(S):/string/;n 

BLANK(S):/stringl/,/string2/ 

BLANK(S):/strir^l/,/string2/;n 

CHANG E(S) 

CHANGE(S);n 

CHANGE(S):/string/ 

CHANGE(S):/string/;n 

CHANGE(S):/stringl/,/string2/ 

CHANGE(S):/stringl/,/string2/;n 

CLEAR 

DEFTAB 
DEFTAB:/tabehar/ 

DELETE(S) 

DELETE(S);n 

DELETE(S):/string/ 

DELETE(S):/string/;n 

DELETE(S):/stringl/,/string2/ 

DELETE(S):/stringl/,/string2/;n 

END 

ES 

ES;n 

ES:/string/ 



For additional information, refer to the Text 



ES:/string/;n 

ES:/stringl/,/string2/ 

ES:/stringl/,/string2/;n 

EXTRACT 

EXTRACT;n 

EXTRACT:/string/ 

EXTRACT:/string/;n 

EXTRACT:/stringl/,/string2/ 

EXTRACT:/stringl/,/string2/;n 

FIND(S) 

FIND(S);n 

CTNEKSji/string/ 

FIND(S):/string/;n 

FIND(S):/stringl/,/string2/ 

FIND(S):/stringl/,/string2/;n 

INSERTS:/stringl/,/string2/;n 

LENGTH;n 
LENGTH;* 

LINE 

LIST(S) 

LIST(S);n 

UST(S):/string/ 

LIST(S):/strii^/;n 

LIST(S):/stringl/,/string2/ 

LIST(S):/stringl/,/string2/;n 

LISTAB 

MERGE:/lfn/ 

MERGE:/lfn/;n 

MERGE:/pfn/ 

MERGE:/pfn/;n 

MERGE:/lfti/,/string/ 

MERGE:/lfn/,/stnng/;n 

MERGE:/pfn/,/string7 

MERGE:/pfn/,/string/;n 
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NUMBER(S) 

NUMBER(S):/string/ 

NUMBER(S):/stringl/./string2/ 

RESET 

RS:/string/ 
RS:/strit«/;n 
RS:/stringl/,/string2/ 
RS:/stringl/,/string2/;n 

SET 
SETgi 



SET;-n 

SET:/string/ 

SET:/string/;n 

STOP 

TAB 

TAB:/ti V 

WIDTH;n (6 < n < 150) 



XEDIT COMMAND INDEX 

This is a list of the commands available under XEDIT. 
Reference Manual. 

ADDn 

ADDLN(S) 

BOTTOM 

BRIEF 

BRIEF+ 

BRIEF- 

CHANGE/strii^l/string2/n 
CHANGE/strir^la...stringlb/strii^2/n 
CHANGES/stringl/string2/m 
CHANGES/stringla...stringlb/string2/m 

COPY(D)fname n 
COPY(D)fname/string/n 
COPY(D)fname/stringl,..string2/n 
COPY(D)fname/stringl string2/n 



DBADL n 

DEFTAB char 

DELETE n 
DELETE/string/n 
DELETE/stringl ..,string2/n 
DELETE/stringl string2/n 

DELETELN 

DELIMIT char 

DEOFm 



For additiwial information, refer to the XEDIT 

DEOR m 

DLBLANKS n 

eEDIT 

END,fname,mode 

EXPLAIN 

FBADL n 

FILE,fname,mode 

HNDLL n 

HELP,command 

INPUT e 

INSERT(B) n 

line number 

LISTAB 

LOCATE/string/n 
LOCATE/stringl...string2/n 

LOCATE/stringl string2/n 

LOCATE/ string2/n 

MODIFY 

NEXTn 
NEXT -n 

NOBELLS 
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OCTCHANGE octl oct2 n 

PRINT n 

QMOD n 

QUIT.fname.mode 

READ(P) fnamei fname2 ••• fnamcn 

REPLACE n 

REPLACELN In n 

RESTORE 

RMARGIN m 

STOP 

TAB(S)ti t2 ... tn (n<8) 

TEOF 

TEOF+ 

TEOF- 

TEOR 

TEOR+ 

TEOR- 



TOP 

TOPNULL 

TRIM 
TR1M+ 
TRIM- 
TRUNCATE n 

VERIFY 

VERIFY+ 

VERIFY- 

WEOF 

WEOR 

WHERE 

WMARGIN Im rm 

YQMOD n 

Y$ cmdi$ cmd2$ ...$cmdn 

Z$ emdi$ cnid2$ ...$emdn 

.n 

-n 
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TERMINAL DEFINITION COMMANDS 



INTRODUCTION 

The network, which lAF uses as a terminal interface, can support many types of terminals. All supported 
terminals are grouped by the network into 15 terminal classes. Each terminal class has specific 
operating characteristics. These are defined by a set of parameters referred to as terminal definitions. 
These terminal definitions are predefined by the network to match closely the operating characteristics 
of actual terminals. Table F-1 lists these terminal definitions, the default values, and the ranges (in 
parentheses) for each of the 15 classes. 

When a terminal logs in to the network, either it is assumed by the network to be of a certain terminal 
class, or it is assigned a terminal class by the network that resembles its actual characteristics. In either 
case, if the characteristics of the terminal do not match those of its assigned terminal class, the user can 
change the values of the terminal definitions or even change the terminal class, using the terminal 
definiticHi commands described in this appendix or the TRMDEF command described in section 4.t 
Terminal definition commands can be entered any time after the terminal identification process is 
complete (refer to Identifying Terminal in section 2), including during lAF operations. The TRMDEF 
command can be entered only when lAF is being used. 

When the TRMDEF command or a terminal definition command is used to change a value, that change 
remains in effect until the terminal is disconnected from the network or another TRMDEF or terminal 
definition command is used to change the value. Even application switching and lAF Ic^out do not 
change the values of the terminal definitions if the terminal has not been disconnected from the 
network. Only by disconnecting the phone and redialing (on dial-up terminals) or by entering the TC 
terminal definition (described in this section) can the values be reset to their default values. 

The TRMDEF command is described under Terminal Control Commands in section 4. All of the terminal I 
defmition parameters in table F-1 can be used with the TRMDEF command unless stated otherwise. | 

TERMINAL DEFINITION COMMAND FORMAT 

The terminal class or terminal definition values can be changed by entering terminal definition 
commands. These commands should be entered in the following format.t t 

control terminal definition @ 

Parameter Description 

control Terminal control character defined for the terminal in use (refer to CT in table 

F-1). ■ 

terminal A two-character mnemonic shown in table F-1, followed by = and the 
definition desired terminal class number or parameter value. The range of values is shown in 
table F-1. 

@ Message terminator character for the terminal in use. 

t It is also possible to charge terminal definitions using control byte 16. Refer to the NOS Reference I 
Manual, volume 2, for information on control bytes. ' | 

T tSpaces are included for clarity. They should not be included when entering the command. 
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As an example, to set the cancel character on a 713 terminal to a ?, press the ESCAPE key and enter 
CN=? 

On terminals from which it is possible to input multiple logical lines in a single transmission block (more 
than one line can be entered before transmitting), the terminal definition control character must be the 
first character in the transmission block. Subsequent input lines in the transmission block are treated as 
data and sent to lAF. When the terminal definition command is a request for transparent input mode 
transparency is not applied to any data in the current transmission block but is applied to the next ' 
transmission. ^^ 

If the user makes a format error while entering a terminal definition command, or enters a command 
which is invalid for the terminal, the mess^e 

ERR.. 
is printed at the terminal. 

In additiMi to the terminal definition commands, a message command (MS) and a character code set 
command (CD), whicli have the ^me format, are available to the user. These commands are described at 
the end of this appendix. MS and CD cannot be used as parameters in the TRMDEF command. 

TERMINAL DEFINITION PARAMETERS 

The following descriptions explain the terminal definition parameters used in the terminal definition 
commands and the TRMDEF command. Default values are not shown since they vary with the terminal 
class. Refer to table F-1 for the default values. ^ terminal 



TERMINAL CLASS |TC) 

The TC parameter specifies a value from 1 to 15 that associates the terminal type with a set of terminal 
Snal claSs^"*'"""'' ^^ *^'"'"*"^* ''"'"^ "'""^ '" '^' "'*"°'"'' ''''°"^' *° °"^ °f the folio wi^ 15 

TC Terminal Type 

1 M33, M35. M37. M38 teletypewriters 

2 CDC 713-10 

3 Reserved for future use 

4 IBM 2741 

5 M40 

6 Hazeltine 2000 

7 CDC 751-1 

8 Tektronix 4000 
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TC 


Terminal Type 


9 


HASP Protocol 


10 


200 User Terminal 


11 


CDC 214 


12 


CDC 711-10 


13 


CDC 714 


14 


CDC 731-12, 732-12 


15 


CDC 734 



A terminal that is not shown as belonging to a terminal class may still be operational. It can be assigned 
to a terminal class having similar characteristics and whose parameters have been changed as necessary 
by site personnel to define correctly the operational characteristics of the terminal. The terminal class 
which supports the new terminal type has operating parameter values different from the default values 
shown in table F-1. 

Terminals connected to the network through autorecognition lines can be assigned to terminal class 1, 4, 
10, or 13 (unless site personnel have configured the network otherwise). When the terminal being used on 
an autorecognition line is other than terminal class 1, 4. 10, or 13, the TC parameter must be changed to 
correctly identify the terminal class. 



CONTROL CHARACTER (CT) 

The CT parameter establishes the character to be used to identify terminal definition commands. When 
this character is entered as the first character in a logical line (or transmission block), the data following 
is assumed to be a terminal definition command. Any character in the ASCII 128-chapacter set, except 
the equals character, can be selected to function as the control character. This character must differ I 

from the characters currently defined for the BS, CN, AL, Bl, and B2 parameters. The character I 

specified by the CT parameter is the character represented by control in the terminal definition 
command format. 



BACKSPACE CHARACTER (BS) 

The BS parameter specifies the character to be used to delete the previous input character. Any 
character in the ASCII 128-character set, except the equals character, can be selected to fuiwtion as the 
backspace character. This character must differ from the characters currently defined for the CT, CN, 
AL, Bl, and B2 parameters. It is possible to backspace only to the beginning of the current physical line- 
additional backspaces are disregarded. When a page width of zero is selected, the characters are sent to 
lAF in multiples of 140 characters regardless of the page width. Backspacing across these 140-character 
boundaries is not possible. 



I 
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CANCEL CHARACTER (CN) 

The CN parameter specifies the character to be used to cancel the logical line currently being input. 
Any character in the ASCII 128-charaeter set, except the equals character, can be selected to function 
^f-r^i^^"^®' character. This character can be the same as the AL (abort output line) character but must 
differ from the characters currently defined for the CT, BS, Bl, and B2 parameters. When the cancel 
character is entered as the last character before @ is pressed, the entire logical line in progress is 
cancelled. If part of the current logical line has already been transmitted to the application, a flag is set 
to inform the application that the cancel character has been entered. The system responds to a cancel 
line character by printing *DEL* on the next Une and positioning the carriage to the beginning of a new 
line. " 



ABORT OUTPUT LINE CHARACTER (AL) 

The AL parameter specifies the character to be used to abort an output logical line. Any character in 

the ASCII 128-ehfirBf»teP SPt PVnent tho Ofinalc nhono/if^m. nnn K« «n2-:<>:.>l __ ii. - -1 i _ , . ,. 

K t mi-- u ' ''" "'~ '^"'"" ^..v..uv,i^,, v,iii. uc ot.eCiiicu «s me eiuurL output line 

character. This character can be the same as the CN (cancel) character but must differ from the 
characters currently defined for the CT, BS, Bl, and B2 parameters. The current output line is discarded 
when the abort line character is entered as the only character in a logical line (entering the abort output 
une character followed by @) while output is in progress. 



INTERRUPTION CHARACTER (Bl] 

The Bl parameter specifies the character that, when entered as the only character in a logical line 
(interruption character followed by @), causes program interruption. This process is discussed in section 
1. The interruption sequence is also called the user breal< 1 sequence. Any character in the ASCII 
^^^-<^^f^&<^^^^ set, except equals, can be specified as the interruption character. This character must 
differ from the characters currently defined for the CT, BS, CN, AL, and B2 parameters. 



TERMINATION CHARACTER (82) 

The B2 parameter specifies the character that, when entered as the only character in a logical line 
(termination character followed by @ ), causes program temination. This process is discussed in section 
1. ine termination sequence is also called the user break 2 sequence. Any character in the ASCII 
i?,®/^^?''®*'*®'" ^*' except equals, can be specified as the termination character. This character must 
differ from the characters currently defined for the CT, BS, CN, AL, and Bl parameters. 

CARRIAGE RETURN IDLE COUNT (CI) 

The CI parameter specifies the number of idle characters to be inserted into the output stream after a 
carringe return. This command is necessary since the length of time for the return operation varies 
dopond.ng on the typo of terminal being used. When n carriage return is entered, the networi< outputs the 
.spccifK-d „umbor of Kilo eharneters before outputtinR the next line. This allows time for the carriage 
re urn function and ensures that characters are not lost because of printing attempts during the carriaee 
return operation. The CI parameter can be assigned .ny value from to 99, or CI=CA can be specifie^to 
restore the carnage return idle count to the default value shown in table F-1 speciiiea to 
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LINE FEED IDLE COUNT (LI) 

The LI parameter specifies the number of idle characters to be inserted into the output stream following 
a line feed. Its purpose is similar to the carriage return idle count (CI) except that the idle characters 
are output after the line feed instead of after the carriage return. The U parameter can be assigned any 
value from to 99, or LI=CA can be specified to restore the line feed idle count to the default value 
shown in table F-1. 



PAGE WIDTH |PW) 

The PW parameter establishes the maximum number of characters that a terminal can print on one 
output line. Page width can be set to any decimal value from to 255. When output occurs at the 
terminal, the carriage is advanced to the b^inning of the next physical line when the number of 
charactCTS displayed equals tMf^^^^ 
advanced to a new physical line because of page width; PW = selects an infinitely long line. 



NOTE [ 



The PW parameter should only be used to establish 
a page width equal to the physical page width of 
the terminal being used. Settii^ page width to 
other values may cause unpredictable results. 



PAGE LENGTH (PL) 



The PL parameter establishes the maximum number of physical lines that can be printed as one page. 
Page length can be set to any value from to 255. PL=0 selects an infinitely long page. During output 
at the terminal, when the number of lines output is one less than the PL parameter selected, a page 
boundary is reached. If page waiting has been selected (refer to the PG parameter) output stops until an 
entry is made at the terminal (@) to continue output of the next p^e. Even if page waitir^ is not 
enabled, the network performs several line feed functions upon reaching a page boundary. This can be 
useful when separating printout paper into individual pages. 



PAGE WAIT (PG) 

The PG parameter specifies whether page waiting is to be performed for the terminal. Page waiting is 
selected by entering PG=Y and cancelled by entering PG=N. Page waiting is in effect only when the 
output device is defined to be a CRT display. When page waiting is selected, output stops at each page 
boundary, and terminal input (@) is required before the next psge is displayed. When the current output 
page is not full, and another page is available for output, the terminal displays 

OVER.. 
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at the end of display^ output. When page waiting is in effect, a nuU input line is used to disDlav the 

^nSr^Jfffi'"*'""^,® ''"!^^= " '^'/° °*^^'" '"^«"'"S- P""«"°"^ "^^'"^lly performTwhen i only is 
entered (for example, continuing after an interruption, causing normal abort processing after a time 
Jmit) are not performed when page wait is in effect and a page is available for outpSf To perform these 
functions, a space followed by @ should be entered. ►'"^ . "' ""ifui. lo periorm tnese 

- In character mode, a page is determined by the number of physical lines specified by the PL parameter. 
I During transparent mode output, the end of transparent output is interpreted as a page boundTry. 
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PARITY SELECTION {PA) 

The PA jMirameter specifies the type of parity that the terminal generates on input and expects on 
output. Parity can be odd (O), even (E), zero (Z), or none (N). In even, odd, or zero parity, ttie network 
checks (or generates) the eighth bit of each character as a parity bit. The network Clears the bk before 
transmitting the character to lAF. If character mode Is set and no parity (N) is specified, the network 

■ does not check for nnritu nnH niitomDf,/.oll„ «ioo„„ *i ,-u*u u.-^ .iT.. •' _ '^ =fcviiicu, uie iieiwoFK 

|rv«.:t.. i^ ™, ■*- "j IZ"-' 7" ', ">-""j v.x^,uLo i,.c ciBiitii Liit, 11 iraiiisparent moae is set and no 
parity is specified, the network transmits all eight bits as data without checking parity. 

SPECIAL EDITlislG (SE) 

'^^^ ^.ift™"'!*®'^ specifies whether the terminal is in special editing mode. Special editing mode is 

It^olt ^- '"?K ^ P^"" '"^ ?"^^H^ *^y ^"*«""S ^^=N- ^*^«" th« terminal^ in specKungmode 
the cancel input, backspace, and Une feed characters are sent to lAF as part of input data If a 
backspace followed by a line feed is entered, the system responds with a caret and line feed. 

network re^To^X*"'^^ ^''"*"^ ^^^^""^^ °" *^^ '"''* '^ ^^^"'""^ ^''"'"^ '' "°* supported at the site, the 

£RR.. 
to entry of the SE parameter. 

TRANSPARENT INPUT MODE DELIMITER |DL| 

The DL parameter specifies transparent input mode text delimiters. DL is vaHd only in a terminal 

?hPeTt*^rrfTr' T '"""t^"' ^""^^J"^^' '' ^ "°' ^^^^'^^ «^ « P«™'"«t«'- •" the TRMDEF command. 
^uflf \^^ of delimiters can be selected: characters, character count, and timeout. Each is optional 
but at least one must be selected. A delimiter character can be any character and is specified wkhXcc 
where ce is a two-hexadecimal-digit representation of the delimiter character in the term inal'sSrao ten 

f 0^4^96 ^■^iTZ^ir^'.^^'r'"' '^1 ''f'^l?'' "'^^ ^^«'"^' '^^^'^ ^«1"« «^" be any dSra vafue from 
ImlutJ^Zl nT "^f^'ter IS selected by including TO. which indicates a timeout of from 200 to 
400 milliseconds. Dehmiters can be entered in any order; trailing commas can be dPletf^ri T*>rminoi 
Class 4 (IBM 2741) is configured with the RETURN key as' the traUaTe^rinput mcSe delile^^^^^^^^^^ 
c1n^;.s 12 and 13 are configured with the ETX koy as the transparent input mode SeUm! LT. Siese 
configurations cannot be changed. v^^ucumne.. mese 

When transparent input mode is initiated, using m=XK. IN=XP, or IN-X, characters entered are sent to 
the .ystom as S-b,t characters (if PA-^N is .sp.cifiec]; oth .wise as 7-bit characters wkh the eiSthbt 
z.;.-ocd without translation, until one of the delimiter vniues is encountered. Norma yeharSers 
apje^l X A? "' "" "■°""''"' """ ''"'"^ '' '-^'* '' ^2-hit internal display'co^es (refe to 



F— fi 

60455250 C 



INPUT DEVICE (IN) 

The IN parameter specifies the input device as a keyboard in character mode (KB), a keyboard in 
transparent input mode (XK), a paper tape reader in character mode (PT), a paper tape reader in 
transparent input mode (XP), or the current input device in transparent input mode (X). The TRMDEF 
command aUows character mode (KB and PT) only; values of XK, XP, and X are illegal. Paper tape input 
is allowed in keyboard mode, but X-ON characters are sent to start the paper tape reader. For 
transparent input mode, the transparent input delimiter (DL) character must have been established 
before transparent input mode is entered or the default delimiter for the terminal class is used. 

OUTPUT DEVICE (OP) 

The OP parameter specifies the output device as a printer (PR), CRT display (BI), or paper tape punch 
(PT). It switches between a paper tape punch (PT) and the default device (DI or PR). DI cannot be 
specified if PR is the default device, and vice versa. Otherwise, printer and CRT display are functionally 
equivalent except for the page wait feature (page wait applies only for OP=DI). The terminal user can 
punch a paper tape in any mode, but the proper X-OFF characters are provided only if OP=PT is selected 
and the terminal is not in transparent mode. 



ECHOPLEX MODE (EP) 

The EP parameter selects input character echoir^. If EP=Y is specified, each character received by the 
network is echoed to the terminal just as it was received. This mode is effective only for terminals 
which have echoplex c^ability. For terminals having a HALF/FULL duplex switch, if this switch is in 
the HALF position when EP=Y is specified, each subsequent character entered is double printed (initiallv 
when It IS typed and again when it is echoed by the system). Placing the switch in the FULL position " 
allows only the character echoed to the terminal to be printed. 

EP=N clears the EP=Y setting. Characters received by the network after EP=N is specified are not 
echoed to the terminal. Characters entered at the terminal are not printed when the HALF/FULL duplex 
switch is in the FULL positiMi. Only system-generated output appears at the terminal. Placing the 
switch m the HALF position allows keyboard entry to be printed. 

MESSAGE COMMAND 

The same network mechanism that allows terminal users to perform the functions provided with the 
terminal definition commands allows them to send messe^es to the local operator. TTie local operator is 
responsible for controlling the communications elements of the network. Functions of the local operator 
include enabling and disabling terminals and applications, determining the status of the various 
communicaticMis elements, and sending messages to terminals (refer to the NOS Operator's Guide for a 
more thorough description of local operator functions). If the user is having problen-.o with the network 
(such as difficulty connecting to lAF), he can communicate these problems to the local operator using the 
message command. The format of this command is as follows: 

control MS=message @ 



I 
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Parameter Description 

control This is the same terminal control character used in the terminal definition 

commands. 

message Message of no more than 50 characters (including spaces) to be sent to the local 

operator. 

'^luS:S'!^1l^rty"Zy."^ *" """' *'' ""' ^' *''^ "' '""^ ^^'■"''™» ^««""*o" commands; spaces are 
Any response from the local operator is printed in the following format. 
FROM THE LOP., message 

I CHARACTER rnnF <ft roMAAAMn 

^! ^l^h*^" ?^V^* command allows a user to change his terminal's character set, usually by means 
?i^^o,^i°".-l-^ i^™'"''^ */ removable type ball. ITiis command can be entered any tkne aft^r the 
terminal identification part of login is complete. The format of the command is aVfollowsT 

control CD=A @ 

Parameter Description 

control This is the same terminal control character used in the terminal definition 

commands. 

.Sud^fUla^'Sy'^nT"' " ''' ""' " '"'* °' ''' ''''""'' '^""•"°" ^°"""^"*^^= ^P«°^^ «- 

After entering the character code set command, the user has 60 seconds to physicallv select the tPrmin«i 
character set (for example, change the type ball) and enter one of the followi^: ^ 

eiH2£te£ Description 

) @ The system determines the terminal's new character set. 

® LMP-J^rt^^^"^^,? character set recognition (valid for standard ASCII terminals 

only). Ttie terminal's new character set is assumed to be ASCH. 

When the sj^tem recognizes the new character set. it issues two line feeds to indicate the user can 

J?ZT ."^r!^ *" *^^'!J,^ P''?««*"* "««^ ^'""g terminal identification to finS the te^La^^^^^^^^^^^^ 
set (refer to Identifying Terminal in section 2). If no entry is made within 60 seconds afterenteHnl5hP 
character code set command, the network disconnects the^erminal. If the character coS^S of ?he 
terminal is not supported at the site, the network issues the message ^"^^cter coae set of the 

UNSUPPORTED CODE SET. 
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TABLE F-1. TERMINAL DEFINITION PARAMETERS 



Terminal Type 


M33, M35, 
M37, M38 


CDC 713-10 


■ Reserved 


IBM 2T41 


Parameter 


Mnemonic 


Terminal class 


TC 


1 


2 


3 


4 


Control character 


CT 


ESC 
(any)t 


ESCAPE 
(any)t 




ATTN % 
(any)t 


Backspace ciiaraeter 


BS 


CTRL/H 
(any)t 


<any)t 




BACKSPACE 
(any) t 


Cancel character 


CN 


CTRL/X 
(any)t 


CTRL/X 
(any)t 




ATTN ( 
(any)t 


Abort output 
- line character 


AL 


CTRL/X 
Cany)t 


CTRL/X 
(My)t 




ATTN ( 
(any) t 


User break 1 
(interruption character) 


Bl 


CTRL/P 
(any)t 


CTRL/P 
(any)t 




ATTN : 
(any)t 


User break 2 
(termination character) 


B2 


CTRL/T 
(any)t 


CTRL/T 
(any)T 




ATTN ) 
(any) t 


Carriage return 
idle count 


CI 


2 
(0-99, CA) 



(0-99, CA) 




2 
(0-99, CA) 


Linefeed 
idl4 count 


U 


1 
(0-99, CA) 



(0-99, CA) 




1 
(0-99, CA) 


Page width 


PW 


72 
(0-255) 


80 
(0-255) 




132 
(0-255) 


Page length 


PL 



(0-255) 



(0-255) 





(0-255) 


Page wait 


PG 


N 
(Y.N) 


N 
(Y.N) 




N 
(Y,N) 


Parity 


PA 


E 
(Z,0,E,N) 


E 
(Z,0,E,N) 




E 
(Z.O.E.N) 


Special editii^ 


SE 


N 
(Y,N) 


N 
(Y.N) 




N 
(Y.N) 


Transparent input 
mode delimiter 


DLtt 


XOD 

C2043 

/Xany \ 

|C1-C4096| 

\ TO / 


XOD 

C2043 

/Xany \ 

(C1-C4096J 

\ TO / 




X 6D 

(X 6D) 


Input device 


INttt 


KB 
(KB,PT,XK,XP,X) 


KB 
(KB,PT,XK,XP,X) 




KB 
(KB.PT.XK.XP.X) 


Output device 


OP 


PR 
(PR.PT) 


01 
(DI.PT) 




PR 

(PR.PT) 


Echoplex mode 


EP 


N 
(Y.N) 


N 

(Y.N) 




N/A 


t The equals character canr 
tf DL Is not a legal paramett 
TTTXK, XP, and X are not leg 


lot be speciHed. 
?r in the TRMDEI 
al values for the 


' command. 

IN parameter in the T 


RMDEF command. 







I 
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TABLE F-1. TERMINAL DEFINITION PARAMETERS (Contd) 



I 
I 



















Terminal Type 


M40 


Hazeltine 2000 


CDC 751-1 


Tektronix 4000 




Parameter 


Mnemonic 




Terminal class 


TC 


5 


6 


■ 

7 


8 




Control character 


CT 


CTRL/P 
(any)t 


ESC 
(any)t 


ESC 
(any)t 


ESC 
(any)t 




Backspace character 


BS 


N/A 


CTRL/H 
(any) t 


(any)t 


CTRL/H 
(any) t 




Cancel character 


CN 


CTRL/X 
(any)t 


CTRL/X 
(any)t 


CTRL/X 
(any) 1 


CTRL/X 
(any)t 




Abort output 
line character 


AL 


CTRL/X 
(any) t 


CTRL/X 
(any)t 


CTRL/X 
(any)t 


CTRL/X 
(any) t 




User break 1 
(interruption character) 


Bi 


(any)t 


CTRL/F 
(any) t 


CTRL/P 
(any)t 


CTRL/P 
(any)t 




User break 2 
(termination character) 


B2 


CTRL/T 
(any) t 


CTRL/T 
(any)t 


CTRL/T 
(any) t 


CTRL/T 
(any)t 




Carriage return 
idle count 


CI 


1 
(0-99. CA) 



(0-99. CA) 



(0-99, CA) 



(0-99. CA) 




Line feed 
idle count 


U 


3 
(0-99. CA) 


3 
(0-99, CA) 


12 
(0-99. CA) 



(0-99, CA) 




Page width 


PW 


74 
(0-255) 


74 
(0-255) 


80 
(0-255) 


74 
(0-255) 




Page length 


PL 



(0-255) 



(0-255) 



(0-255) 



(0-255) 




Page wait 


PG 


N 
(Y.N) 


N 
(Y.N) 


N 
(Y.N) 


N 
(Y.N) 




Parity 


PA 


E 
(Z.O.E.N) 


E 
(Z.O.E.N) 


E 
(Z,O.E,N) 


E 
(Z,0,E.N) 




Special editing 


SE 


N 
(Y.N) 


N 
(Y.N) 


N 
(Y.N) 


N 

(Y.N) 




Transparent input 
mode delimiter 


DLtt 


XOD 

C2043 

/ X any \ 

{ C1-C4096 1 

\ TO / 


X OD 

C2043 

/ X any \ 

1 C1-C4096 ) 

\ TO / 


XOD 

C2043 

/ X any \ 

Ici-C4096l 


XOO 

C2043 

/Xany \ 

ICl-C4096l 




Input device 


INttt 


KB 
(KB.PT.XK.XP.X) 


KB 
(KB.PT.XK.XP.X) 


KB 
(KB.PT.XK.XP,X) 


KB 
(KB.PT.XK.XP.X) 




Output device 


OP 


DI 
(DI.PT) 


DI 

(DI.PT) 


DI 
(DI.PT) 


DI 
(DI.PT) 




Echoplex mode 


EP 


N 
(Y.N) 


N 
(Y.N) 


N 
(Y.N) 


N 
(Y.N) 




t The equals character cann 
tt DL Is not a legal paramet* 
W XK. YP, and X are not leg 


ot be specified, 
'r in the TRMDEF 
al values for the 


command. 

N parameter in the T 


RMDEF command. 
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TABLE F-1. TERMINAL DEFINITION PARAMETERS (Caitd) 



Terminal Type 


HASP 
Protocol 


200UT 


CDC 214 


CDC 711-10 


Parameter 


Mnemonic 


Terminal class 


TC 


9. 


10 


11 


12 


Control character 


CT 


% 
(any)t 


% 
(any)t 


(any) t 


% 
(any)t 


Backspace character 


BS 


N/A 


N/A 


N/A 


N/A 


Cancel character 


CN 


( 
(any)t 


( 
(any)t 


( 
(any) t 


( 
(any) t 


Abortoutput 

line character 


Al, 


N/A 


N7A 


N/A 


N/A 


User break 1 
(interruption character) 


Bl 


(aiiy)t 


(aiiy) t 


(any) t 


(aiiy) t 


User t>reak 2 
(termination character) 


B2 


) 
(any)t 


) 
(any) t 


) 
(any) t 


) 
(any) t 


Carriage return 
. idle count 


CI 


N/A 


N/A 


N/A 


N/A 


Line feed 
idle count 


U 


N/A 


■ N/A ■ 


N/A 


N/A 


Page width 


PW 


80 
(0-255) 


80 
(0-255) 


80 
(0-255) 


80 
(0-255) 


Page length 


PL 



(0) 


13 
(0-255) 


13 
(0-255) 


16 
(0-255) 


Page wait 


PG 


N/A 


y 

(Y.N) 


Y 
(Y.N) 


Y 
(Y.N) 


Parity 


PA 


N/A 



(0) 




(0) 



(0) 


Special editing 


SE 


N/A 


N/A 


N/A 


N/A 


Transparent input 
mode delimiter 


DLtt 


N/A 


N/A 


N/A 


X03 
(X 03) 


Input device 


IN ttt 


KB 
(KB) 


KB 
(KB). 


KB 
(KB.X) 


KB 
(KB.XK) 


Output device 


OP 


DI 
(DI) 


01 
(DO 


DI 
(DI) 


DI 
(DI) 


Echoplex mode 


EP 


N/A 


N/A 


N/A 


N/A 


t The equals character cam 
tt DL is not a legal para met 
ttt XK, XP, and X ere not lef 


lot be specified, 
er in the TRMDEI 
ral values for the 


" command. 

IN parameter in the T 


RMDEF command. 
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TABLE F-1. TERMINAL DEFINITION PARAMETERS (Contd) 



Terminal Type 


CDC 714 


CDC 731-12 
CDC 732-12 


CDC 734 


Parameter 


Mnemonic 


Terminal class 


TC 


13 


14 


15 


Control character 


CT 


% 
(any) t 


* 
(any) t 


(any) t 


Backspace character 


BS 


N/A 


N/A 


N/A 


Cancel character 


CN 


( 
(any) t 


( 
(any) t 


( 
(any) t 


Abort output 
line character 


AL 


N/A 


N/A 


N/A 


User break 1 
(intem4>tion character) 


Bl 


(any)t 


(any) t 


(aiiy) t 


User break 2 
(termination character) 


B2 


) 
(any) t 


) 
(any) t 


) 
(any)t 


Carriage return 
idle count 


CI 


N/A 


N/A 


N/A 


Line feed 
idle coimt 


U 


N/A 


N/A 


N/A 


Page width 


PW 


80 
(0-255) 


80 
(0-255) 


80 
(0-255) 


Page length 


PL 


16 
(0-255) 


13 
(0-255) 


13 
(0-255) 


Page wait 


PG 


Y 

(Y.N) 


Y 

. (Y.N) 


Y 
(Y.N) 


Parity 


PA 



(0) 



(0) 



(0) 


Special editing 


SE 


N/A 


N/A 


N/A 


Transparent input 
mode delimiter 


DLtt 


X 03 
(X 03) 


N/A 


N/A 


Input device 


IN W 


KB 
(KB.XK.X) 


KB 
(KB) 


KB 
(KB) 


Output device 


OP 


Dl 

(Dl) 


Dl 
(Dl) 


Dl 
(Dl) 


Echoplex mode 


EP 


N/A 


N/A 


N/A 


t The equals character cannot be specified. 

tt DL is not a legal parameter in the TRMDEF command. 

ttT XK, XP. and X are not legal values for the IN parameter in the TRMDEF command. 
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LINE FEED AND TRANSMISSION KEYS 



Table G-1 shows the keys used by the supported terminal classes to advance the catris^e or cursor to the 
beginning of the next line and/or transmit messages from the terminal. The terminal classes are 
described in appendix F. The keys listed in table G-1 are divided functionally into three types called 
carriage return, new line, and line feed. 



TABLE G-1. TERMINAL KEY EQUiyALENCES 



Terminal Class 


Function 


Carriage Return 


New Line 


Line Feed 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 


RETURN 
RETURN 

RETURN 

RETURN 

CR 

CARRIAGE RETURNt 

RETURN 

Varies^" ^ 

SEND 

SEND 

ETX 

ETX 

ETX 

SEND 


N/A 
N/A 

N/A 
N/A 
N/A 
N/At 
N/A 

Variest t 
RETURN 
RETURN 
NEW LINE 
NEW LINE 
NEW LINE 
NEW LINE 


UNEFEED 

\ 

ATTN 

NEW LINE 

LF 

LINE FEEDt 

LF 

Variest t 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 


tif in block mode, the user should refer to terminal documentation for terminal key equivalences. 
Those listed are for character and line modes. 
t tTerminals operating under HASP protocol use different keys for this purpose. 
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Il!fo^""''^'°"' 1^'!!'°^ the three types of keys provides for the terminal user and how lAF interprets each 
type are described in the following paragraphs. mierpreis eacn 

Tertninal user functions are: 

TyP« of Key Function 

Carriage return Terminates a message, advances the cursor or carriage to the beginning of 

the next line, and transmits the message. It also transmits any other 
messages which may be stored in the terminal's buffer. 

Terminates the message and advances the cursor or carriage, but does not 
transmit the message. Rather, it causes the message to be stored in the 
terminal's buffer until the carriage return function is used. Many terminals 
cannot activate the new line function and on other terminals the new line key 
d(^s not activate the new line function. Refer to terminal documentation fw 
information concerning the keys on the terminal. " 

Terminates a physical line of input and advances the cursor or carriage to the 



New line 



Line feed 



beginning of the next Bne. 
lAF interprets these functions as: 

"^^ °f K^y lAF Interpretation 

Carriage return Terminates a message. 

New line iSf be'^^^^tS!^^^' ^"'^^^J''^"* messages in the same transmission may 

Line feed Causes Une transmission to lAF, which lAF interprets as a complete 

JTsHSfs^fuS!^ ^^ '^'""' ^"^ unpredictable, the user is encouraged not to 
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DIFFERENCES BETWEEN TELEX AND lAF H 



OVERVIEW AND INTRODUCTION 

A number of differences exist between lAF and TELEX because of lAF's use of Network Products and the 
Network Access Method (NAM) for terminal communications. The differences are caused mainly by the 
movement of all specific terminal control to the CDC Network Products System. The TELEX 
replacement, lAF, addresses all interactive time-sharing terminals as virtual terminals. However, the 
TELEX ability to address the specifics of a terminal in what was called binary mode is still preserved 
^^^JJ^^J^^'^J"'^ Pi'o^'cts System this capability is referred to.as.tra.nsparent mode. The feature of 
ThLbX referred to as transparent mode has been renamed special editing mode. 

The changes from TELEX to lAF primarily involve terminal operations. Great care has been exercised to 
minimize any changes that might affect user programs. Changes that might affect user programs are 
listed under Input/Output Data Handling Including Control Bytes and Additional Data Return from 
TSTATUS Macro in this appendix. The vast majority of user programs are not affected by running with 



NOTE I 



The chaises affecting end users are described 
starting at Identifying Terminal to Network 
throi^h Paper Tape in this appendix. The 
remaining paragraphs affect site operations only. 

The greatest benefit of using lAF with NAM for terminal communications is that any terminal supported 
under the Network Products Interactive Virtual Terminal feature can be used for interactive 
time-sharing work on NOS. Specifically, this means that asynchronous terminals up to 9609 baud and 
synchronous terminals up to 9600 baud can be used on NOS as time-sharing terminals. Information on the 
types of terminals, hne speeds, and communications protocols supported by network products is found in 
the Network Products literature (refer to the preface for a Ust of related publications). This appendix 
does not repeat the information given in the Network Products network, nor on how to operate such a 
network. Since this appendix discusses TELEX-to-IAF differences, it does not cover terminal operations 
when used in other than nwmal interactive use. 
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CHANGES AFFECTING END USERS 

The changes that may affect end users are described in the following paragraphs. 

IDENTIFYING TERMINAL TO NETWORK 

There is no change when the terminal is of the same class as the default terminal class for the line on 
which the terminal is connected. 

If the terminal is other than the default class, then under TELEX the terminal operator identified his 
terminal class by entering one of the following: 

• ATTN key for correspondence code standard print terminals. 

• A then ATTN for correspondence code APL print terminals. 

• A for Memorex 1240 terminals with APL. 

• B for block transmissicm ASCII code terminals. 
Under lAF/Network Products, the user enters the following: 

• SEND for mode 4A t^minals. 

• ETX for mode 4C terminals. 

• @ for all other terminals. This causes the system to determine automatically the line speed of 
the terminal. When the line speed is recognized, the system issues two line feeds. The user 
enters) @ to cause automatic detection of the terminal character set or, for ASCII terminals 
only,® alone to bypass character set detection. Two additional Une feeds indicate the 
terminal character set has been recognized and the terminal identification procedure is 
complete. 

■Hie user can then enter a terminal class command (necessary only if the terminal class is different from 
the default). Information on the possible terminal classes is contained in the Network Products literature 
and m appendix F. 



LOGIN PROCEDURE 

Under TELEX, most terminals made use of only the interactive time-sharing capability. A few made use 
of both the time-sharing capability and TAF. A completely different set of terminals was used under 
Export/Import and these had only remote batch capability. 

For the great majority of time-sharing terminals that use only the interactive time-sharing capability of 
NOS, the login procedure need not change at all. The following sequences show the differences. 
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• Login sequence for a network terminal: 

Line 1 - yy/mm/dd. hh.mm.ss. termnam 

Line 2 - system header line 

Line 3 - FAMILY: aaaaaaa (zero to seven alphanumeric characters) 

Line 4 - USER NAME: aaaaaaa (one to seven alphanumeric characters or •) 

Line 5 - PASSWORD: 

Line 6 - ******** (user overtypes one to seven alphanumeric characters) 

Une 7 - TERMINAL nnn, NAMIAF 

• Login sequence for a TELEX terminal: 

Line 1 - yy/mm/dd. hh.mm.ss. 

Line 2 - system header line 

Line 3 - FAMILY: aaaaaaa (zero to seven alphanumeric characters) 

Line 4 - USER NUMBER: aaaaaaa (one to seven alphanumeric characters or *) 

Line 5 - PASSWORD. 

Line 6 - ******** (user overtypes one to seven alphanumeric characters) 

Line 7 - TERMINAL nn, TTY 

The termnam field in line 1 of the network login sequence contains the network terminal name. This 
network terminal name is the name used in a network configuration file at the host to identify the port 
(for dial-up lines) or the terminal. The nnn in line 7 is the identifier a terminal operator needs to recover 
an mteractive session with lAF after an interruption. The nn in line 7 of the TELEX session was the 
number a TELEX user needed to recover a TELEX interactive session. 

The family name is always requested even if only one family exists. 

The prompt USER NAME has been adopted in place of USER NUMBER, since the former is more 
meaningful. 

As was true with TELEX, the login session for network terminals can be abbreviated by entering 
familyname, username, and password on one line in response to the FAMILY prompt. 

Terminal operators who used both TELEX and TAF accessed TAF by logging into TELEX and then 
entering TAF via the TRAN command. Under the Network Products System, TAF is accessed directly 
from the network, not via TELEX or lAF. Therefore, TAF can be used when lAF is not available. For a 
network user who is allowed to access more than just lAF, the network provides an additional Dromot line 
after the PASSWORD prompt. 

Line 6B - termnam - APPLICATION: aaaaaaa (one to seven alphanumeric characters) 
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The user enters either lAF or TAF. Again, this entry can be added to the line of parameters entered in 
response to the FAMILY prompt; the user can enter familyname, usemame, password, and applicatioi in 
response to the FAMILY prompt. Similarly, the user can enter usemame, password, and appUcation in 

v^^X^V^^ "^^^ ^^^^ prompt; and the user can enter password and application in response to the 
PASSWORD prompt. 

The foUowing new optional capabiUties are being added to network products login capability. 

• Automatic initial application selection, "nie terminal is required to CMineet to this application 
first; no application prompt is given. 

• Default initial application selection. The user is validated for only one application- no 
application prompt is given. 

• Automatic login. A terminal entering the system on a specific set of ports is given a default 
usemame and is automatically connected to a specific application. This feature is useful for 
eonnecUng terminals on hardwired lines to TAF for transaction appUcations or for connecting 
time-shanng terminals oii hardwired lines in a university computer lab to lAF. 



The lAF/Network Products do not check for an 
answerback code. 



lAF RECOVERY PROCEDURES 



When recovering a terminal session under TELEX, a terminal user normally entered the nn number 
displayed in line 7 of the login sequence. However, often if a user redialed in immediately it was not 
necessanr to enter this number because the user would get the same port. If the terminal was on a 

thfrn^ffr"^', t"?iK°"^*l^^ ^"^"'^ ^^^ "" ^""^'^ "°* '=»^«"g«- Under the Network Products System, 
the nnn of line 7 should be entered to recover a session; it will almost assuredly be different, whether on 
a dial-up or hardwired line. 



TELEX AND lAF COMMAND DIFFERENCES 

The foUowing TELEX commands have been replaced in lAF/Network Products by the terminal definition 
parameters indicated (refer to appendix F). The functions performed by the TELEX commands are now a 
part of the specific terminal handling functions performed by Network Products for lAF (and for all other 
host network applications as well). 



TELEX Command Terminal Definition Parameters 

BINARY 



DL (specifies a transparent input mode delimiter) 



IN (specifies whether input is from keyboard or paper tape and whether it is 
normal or transparent) 

PA (specifies whether parity is zero, odd, even, or none) 
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TELEX Command Terminal Definition Parameters 



EP (specifies echoplex mode) 



ROUT CI (specifies number of rubouts) 

TERM TC (specifies terminal class) 

FULL 
HALF 

The STOP command has been replaced by a termination character (also called user break 2) described I 

under Termination of Executing Program in section 1. ■ 

The TRAN command has been replaced by application selection during the Ic^in sequence. 

The BYE command can work as it has under TELEX. Under lAF it has some additional formats which 
are explained under lAF Logout and Network Logout in this appendix. 

INPUT/OUTPUT DATA HANDLING INCLUDING CONTROL BYTES 

The foUowing paragraphs contain data relevant to input/output data handling. 

Line Editing ■ 

Under TELEX, a user could backspace and re-enter input by using the backspace key (sometimes left 
arrow or underscore). With lAF, backspacing is done by using the logical BS character, which might be 
left arrow or underscore, or a character the user at the terminal chooses. 

To be consistent with what now constitutes a logical line (with lAF/Network Products it can be multiple 
physical lines), there has been a change in the range that backspace can affect. Under lAF, a user can 
backspace only to the start of the physical line (which in most cases is the left mamin of the line beine 
entered). * 

To delete a logical line being entered, a TELEX user used the ESCAPE key. Under lAF/Network 
Products, the terminal operator uses the logical CN (cancel input line) character, which is either the 
delault character or a character he chooses for use on his terminal. 

Auto Mode 

Under TELEX, auto mode could be terminated with the BREAK key, by backspacing completely through 
the hne numbered prompt (and not starting the replacement line with a numeric), or by performing a Une 
belTsed "°* starting the replacement with a numeric). Under lAF, only the line cancel approach can 

In auto mode under TELEX, the user could backspace into the prompt and reenter part or all of tht 
nurnber to change the sequence number or to add a character in column 6. Under lAF. the user must 
perform a logical line cancel and then retype tho new number or the same number if a character must be 
placed m column 6. 
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Keeping Output Logical Lines Together 



The lAF/Network Products user who is operating on the same asynchronous terminal used under TELEX 
wiU not experience a change. Even if lAF sends a logical Une to the terminal in multiple network 
transniission blocks (refer to following paragraph), lAF places format effectors on the data so that it is 
formatted properly on the terminal. 

Because synchronous terminals usually start a new line for each network transmission block received it 

Ki^iP°''irK* *• ''"°'*1 "^^^ v^"/ ^P"* " ^°^'''^^ ""® ^""" « program into separate network transmission' 
blocks. If haying output split (a new line starting in the middle) is a problem, then the programmer 
should avoid the following: ^ ^ 

• Outputting logical lines over 225 ASCII characters long. 

• Writing EOF/EOR before placing the entire logical line in the buffer. 

• Making an input request before placing the entire logical line in the buffer. 

• Making a WRITE request when the buffer is full and has no line terminators. 

Line Folding 

This is a new feature of lAF/Network Products that was not available with TELEX. TELEX overprinted 
m the rightmost position of a teletypewriter or any other terminal that did not automatically perform 
carnage return/line feed at right margin. For those terminals, the network performs automati^ line 
folding of hnes whose length equals or exceeds the stated page width of the terminal. A default oaee 
width is established for each terminal at the time it is connected to the network. This default is based 
on information found in the network's configuration files. This value may be altered by the user with the 
PW terminal definiticMi parameter (appendix F). uaci wmi me 



Page Wait 

This is a new feature of lAF/Network Products that was not available with TELEX. This feature is 
apphcable only to display terminals. The network optionally provides the page wait feature to a 
terminal. When page waiting is enabled, output ceases whenever a specified number of lines has been 
sent to the terminal. This allows the user time to read the output or perform other activities. 

JiH^nn?t^^^ '" transmitted When the user enters an input line. Any input line causes page turning, but 
the input IS discarded. An interactive application is not aware of this feature. Two terminal definition 

rp™gT(appendix"FT '° '"'"' °'" '"'"' ^"^' "'"'' '"' ^"^ '" '^'''^' ""'"''" °^ physrcaHineTon 
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Control Bytes 

Because TAF does not use lAF for terminal communicaticai, certain TAF-only control bytes (0010 - End 
of Transaction Message and 0012 - End of Marked Transacticm Output) are discontinued. 

The format of output on teletypewriters may not be exactly the same as on synchronous CRT devices 
because most synchronous CRTs perform a carriage return/line feed automatically at the end of a line, 
instead of under program control. Therefore, the control byte to prevent cursor movement after printing 
does not apply to most synchronous CRTs. 

The 0005 control byte retains only two of the three functions it had under TELEX. It still causes input 
prompt suppression and causes the next input to be interpreted as 6/12H3it internal display codes. 
However, the function of special handling for input editing (backspace, input line cancel, and line feed) is 
now done when the terminal is placed in special editing mode, which is done with the SE terminal 
definition parameter (appendix F). 



lAF LOGOUT AND NETWORK LOGOUT 

The simple use of BYE or HELLO on lAF performs the same function as on TELEX. BYE causes the 
terminal to be lo^ed out of both lAF and the network. HELLO causes the terminal to be logged out of 
lAF and transferred to the network. Login prompts begin with the assumpticm that a new user is at the 
terminaL 

Enterii^ BYE, application name (for example, BYE, TAF) causes the user to be transferred to the named 
application. Internally in NOS, the user is validated to ensure that he is allowed to access the named 
application. 



ADDrTIONAL DATA RETURN FROM TSTATUS MACRO 

The user of this system macro finds the following chaises in the response. 

• The terminal type identificaticm (returned in bits 59 through 18 of word 0) is NAMIAF for all 
network terminals. 

• The transmission code (returned in bits 17 through 12 of word 1) is 3. 

• A new field has been added in bits 43 throigh 36 of word 1 to ccxitain the terminal class 
(appendix F). 
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PAPER TAPE 

Because Network Products offer full virtual terminal appearances to lAF for terminal input and output, 
lAF processes paper tape input as it would keyboard input. A null input line from paper tape has the 
same effect as it does from the keyboard. In normal mode it invokes a status response, and in text mode 
It inserts a blank line into the primary file. Under TELEX, paper tape input ignored nuU input lines. 

Paper tape input is initiated using the IN (input mode selection) terminal definition parameter (appendix 
F) instead of the former TELEX TAPE command. 

Under TELEX input parity was not checked and, therefore, input parity and output parity could be 
different. Under lAF, input and output parity must match. This affects applications, such as numeric 
control, that attempt to punch paper tape in a different parity than the setting of the terminal. 

CHANGES AFFECTING ONLY SITE OPERATIONS 

The chaises that affect only site operations are described in the following paragraphs. 



MODVAL — ADDITIONAL VALIDATION INFORMATION 

The validatiOT file includes information used by the Network Validation Facility in determining whether a 
given user may be transferred to a requested application. This allows a site to control use of aw>lieations 
by users, much in the same way that it controls user capabilities through the access word. With Network 
Products, bits 47 through 24 of the access word are used to coitrol application access. 

A conversion aid is supplied as a MODVAL control statement option to avoid spurious generation of 
applicatiai validation (AP) directives from existing validation files. This problem occurs only when the 
existing access word has bits set in positions 47 through 24 (such as users with AW=ALL privileges) The 
control statement parameter SP causes MODVAL to ignore all application permission bits and enter an 
AP=NUL statement directive in the source file for each user record. Failure to use the SP parameter 
(fering conversion (or failure to perform the conversion) simply means that users with bits set in positions 
47 thwM^h 24 of the access word could have access to appBcations they are not entitled to use. 

NETWORK DESCRIPTION FILES — REQUIREMENTS 

lAF does not require network description files although TELEX did. TAF interfacing with the network 
now requires a separate network description file. 

lAF must know how many terminals it is expected to accept simultaneously. The number of terminals 
formerly specified in a network description file, us now specified in a CMRDECK entry (refer to the 
CMRDRCK section in the Installation Handbook). 



^"^ 60455250 C 



DSD T DISPLAY 



Minor changes have been made to this display to present more Infon.-.ation. A new first column has been 
added indicating whether a terminal is a network terminal (NAM) or a stimulator terminal (MUX). The 
LINE column displays the application connection number (ACN) for network terminals rather than a line 
or port number. The word TELEX in the display header has been changed to TIMESHARING. 



NOTE 



The ACN cannot be used to identify a physical 
terminal or port number. An ACN is simply an 
internal identification of a connection between 
NAM and lArF which remains valid only for the life 
of that connection. 



TAF/TS AND TAF/NAM 

lAF does not interface with TAF/TS. TAF/NAM is an independent appUeation which communicates 
directly with terminals. 



CONSOLE OPERATORS lAF INITIALIZATION COMMAND 

The command lAFffffl" is used to initialize lAF, if this has not been done with the AUTO command. If 
the network software is running, lAF begins operation. 

If NAM is not available, lAF issues the message WAITING FOR NETWORK to the B display and 
periodically attempts a network connection until either it is successful or the operator terminates it bv 
entering l.STOP. •* 



TERMINAL FILE EST ASSIGNMENT 

To provide compatibility with TELEX, all terminal input and output files are assigned to a dummy device 
TT, defined as EST ordinal 75. o j , 



f The char-'ictors ffff arc optional; if penuired, silo [)orsonnel must supply the one to four alnhanuiu 
chnractcrs lo be used. 






INDEX 
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Abbreviating commands 4-1; 8-1 

Abort output line character F-4 
I ACCESS command 2-7; 4-7 

Access count 5-23 

Access mode 5-1,3,18 

Access subsystem 1-2; 4-7 

Access word 4-36,37 

Account block limit 4-28 

Accounting permit 5-20,23 

Accumulated CPU time 4-14,20 

Acoustic coupler 2-1,4 

Add line numbers 6-2 

Advance carriage/cursor G-1 

AL parameter F-4 

Alter line number 4-3; 6-1 

Alternate catalog requests 5-1,2,15,21 

Alternate system 2-6 

Alternate user access 5-1,2,15,21 

APL command 4-11 

APPEND command 5-7 

Append mode 5-3 

Application 2-6,10 

Application switching 2-10 

ASCII character set 4-3; A-1 

ASCII code A-2 

ASCII code set A-1 

ASCII code terminals 2-5; A-7,9 

ASCII command 4-2,3; A-1, 2 

ASCII mode 4-5 

ASCII to display code conversion A-5 

ATTACH command 5-7 

ATTN key 1-6 

AUTO command 3-4; 4-3 

Automatic generation of line numbers 4-3 

Automatic read-only permissicMi 5-1 

Automatic subsystem selection 2-9; 3-4- 

4-7; 5-4,12 
Autorecognition lines 2-4; F-3 
Auxiliary device 4-35; 5-1,5,11 



Backspace character vi; 1-4; 4-2; F-3 

BASIC command 2-7; 4-8 

BASIC subsystem 1-3; 4-8 

BATCH command 2-7; 4-8; 8-1 

Batch job submittal 4-30; 7-1 

Batch output 8-2 

Batch subsystem 1-3; 4-8; 8-1 

Baud rate switch 2-2 

BEGIN command 4-11 



Beginning-of-information 3-1 
Binary input mode H-1 
Blank lines 3-5 
Block mode G-1 
Block size 

Direct access file 5-2; D-1 
Indirect access file 5-1 
BOI (beginning-of-information) 3-1 
BREAK key 1-6 
BRIEF command 4-4 
BS parameter F-3 

2-10; 3-8; 4-1,2; 5-8 

1-7; F-1 

F-4 

F-4 



nxrry « 

ui£. uommana 
Bytes, control 
Bl parameter 
B2 parameter 



CALL command 4-13 

Calling procedure files 4-11,13,30 

Cancel line character 1-4; 4-2,3; F-4 

Carriage return v; G-1, 2 

Carriage return idle count F-4 

Catalog entries 5-13,17 

Catalog, permanent file 5-1 

Category, file 5-3 

CATLIST command 5-13 

CCL 4-11 

CD command 2-5; F-2,8 

CDC graphic character set A-1 

CE keyword 5-6,8 

cEC directive 7-5 

Central memory character equivalents A-8 

Central memory dump 6-12; B-1 

Central memory limit 4-35; 7-6 

Central memory word 3-1 

Central processor time limit 4-29,35; 7-6 

cEOF directive 7-3 

cEOR directive 7-3 

CHANGE command 5-8 

Changing applications 2-10 

Changing character sets 4-15; A-7 

Character code set 2-5; F-8 

Character code set command F-8 

Character count delimiter F-6 

Character delimiter E-6 

Character echoing F-7 

Character mode 9-3; F-6,7 

Character set 4-35; A-1 

Character set conversion A-7 

Character set mode 4-5 
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CHARGE command 2-9; 4-14 

Charge/project number 2-9; 4-14 

CI parameter F-4 

Circumflex character A-8 

cJOB directive 7-3 

Class, terminal 1-1,2 

CLEAR command 3-8; 4-15; 5-8 

Clear error flag 5-6 

CN parameter F-4 

cNOPACK directive 7-3 

cNOSEQ directive 7-3 

cNOTRANS directive 7-4 

Code set 2-5; A-1,2; F-8 

Colon character A-2,8 

Com mand 

Abbreviation 4-1 
Entry of 4-1,2 
Error correction 4-2 
Format, permanent files 5-2 
Maximum number of characters 4-2 
Minimum number of characters 4-1 
Processing 4-1,2 

Comparison of lAF/TELEX H-1 

Compile/execute file 4-27 

Compiled program 4-8 

Compress a file 4-25 

Connect time 2-10 

Continue job after suspension 6-4 

Control bytes 1-7; F-1 

Control characters 4-2; 9-2; A-1 

Control characters, terminal F-1, 3 

Control key vi; 2-6 

Control lai^uage 4-11,13 

Control registers 4-20 

Control state m ents 7-1 ; 8-1 

CwiventicMis 
Manual v 
Numeric 4-2 
Operatii^ 1-3 

Convert 

ASCn to 6/12 display code A-5 
Old to new time-sharing record A-7 
63- to 64-character set A-7 

CONVERT command 4-15; A-7 

Correct input line 1-4; 4-2; 6-1 

Correcting errors 4-2 

Correcting program statements 6-1 

CorrecticHis of paper tape 9-4 

Correspondence code terminals 2-3; A-7 

cPACK directive 7-3 

CPU priority 4-20 

CPU time, accumulated 4-20 

@ v; 4-15 

cREAD directive 7-4 

Creating a file 4-18,24,30,33; 5-9,12 

cREWIND directive 7-5 

CRT display F-1 

cSEQ directive 7-3 



CSET command 4-5; A-1 
CT parameter F-3 
cTRANS directive 7-3 
CTRL key vi; 9-2 
CYBER Control Language 
CYBER Interactive Debug 



4-11 
4-17 



Data entry 1-3; A-8 

Data set 2-1,4 

Dayfile 7-10 

DAYFILE command 4-15 

Dayfile messages 4-15,36 

DEBUG command 4-17 

Default file 3-3 

Deferred batch jobs 4-30,35; 7-1 

DEFINE command 5-9 

Delay carriage return (refer to ROUT 

command) 
Delete input lines 1-4; 4-2; 6-1; F-4 
Delete program statement 6-1 
Delimiter, transparent mode F-6 
Device 

Input F-7 

Output F-7 
Device number 5-17 
Device types 5-4; D-1 
Diagnostics B-1 
DIAL command 4-17 
Dial-in procedure 2-4 
Differences, lAF/TELEX H-1 
Direct access files 3-3; 5-1,2,7,9 
Direct entry of data 4-19,30 
Disconnect terminal 2-10; 4-26; 6-7 
Display code 4-3; A-2 
Dispose files limit 4-20 
DL parameter F-6 
Dollar sign 4-2 
Duplex 2-2; F-7 



Echoplex mode F-7 

ECS and LCM differences vi 

ECS limit 4-36 

EDIT command 4-18 

Editing a program 4-18,33; 6-1 

End-of-file 3-1; 7-3 

End-of-information 3-1 

End-of^^cord 3-1; 7-3 

ENQUIRE command 3-5; 4-19; 7-2 

Entry 

Application 2-6,10 

Batch control statements 8-1 

Charge/project number 2-9; 4-14 

Commands 4-1,2; 8-2 

Data A-8 



kidex-Z 
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Direct 4-19,30 
Errors 4-2 
Family name 2-6 
lAF commands 4-1 
Job 7-1 

Lowercase letters 4-3 
Numbers 4-2 
Password 2-6; 4-26 
Subsystem 2-7; 4-7 
Terminal identification 2-4 
User name 2-6 
EOF (end-of-file) 3-1; 7-3,7 
EOI (end-of-information) 3-1 
EOR (end-of -record) 3-1; 7-3,7 
EP parameter F-7 
-ERR F-2,6 
Error conditions 6-12 
Error correction 4-2 
Error f1n<r 4-9ft- R-ld 9i 

Error messages B-1 
Error processing 7-7,10 
ESC (ESCAPE) key 9-3 
Escape character 7-1,2 
Escape codes A-2 
ETX key v 

Even/odd parity switch 2-2 
Exchange package 6-12 
EXECUTE command 2-7; 4-8 
Execute file 4-27 
Execute mode 5-4 
EXECUTE status 4-15 
Execute subsystem 1-3; 4-8,28 
EXIT control statement 7-7 
Exit from batch subsystem 8-2 
Exit processing 7-7,10 
- Explicit permission 5-13 
I Extended memory differences vi 



Execution 4-27 

Indirect access 3-3; 5-1 

Interlock 5-6 

Length 4-22 

Limit 4-35 

Line numbers 3-4 

Local 3-3 

Name 2-8; 3-2; 4-22; 5-2; 7-1 

Organization 3-1 

Password 5-3 

Permission information 5-3 

Primary 3-3; 4-24,25,26 

Processing 3-1 

Reformatting 7-2 

Release 4-26 

Rename 4-26; 6-8 

Reserved name 3-2 

Residency 5-4,15 

Kewind 4-27 

Size 3-1 

Sorting 3-4; 4-24,29 

Status 4-20,22 

Structure 3-1 

Subsystem association 3-4; 4-7; 
5-4,13 

Temporary 3-3 

TVpes 4-22 
Folding lines H-6 
FORTRAN command 2-7; 4-9 
FORTRAN Extended (refer to FTNTS) 
FORTRAN subsystem 1-3; 4-9 
FTNTS command 2-7; 4-10 
FTNTS subsystem 1-3; 4-10 
Full duplex/half duplex (FDX/HDX) switch 
2-2; F-7 



I 
I 



Family devices 5-1 
Family name 2-6; 4-20 
Feedwheel 9-1 

Field length 2-7; 4-20,28,35; 8-1 
Field length required for control 
statements 8-1 
Field length specified on RUN command 

4-28 
File 

Access 5-3 

Catalog 5-1 

Category 5-3 

Compilation 4-27 

Copy 4-23 

Creation 4-24; 5-9,12 

Definition 3-1 

Direct access 3-3; 5-1,2 

Editing 6-1 



Generate binary (object code) file 4-27 

GET command 3-3; 5-1,10 

Glossary C-1 

GOODBYE command 2-10; 3-8; 4-21; 5-8 

Graphic characters 4-3; A-1 



Hardwired terminal 2-1,4 

Header 4-4,24,29 

HELLO command 2-10; 3-8; 4-21; 5-8 

HELP command 4-22 

Hexadecimal codes A-2 



lAF commands 4-1 
lAF/TELEX differences 
IBM 2741 terminals 1-6 
Identifying terminal 2-4 



H-1 
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5-13 



F-2 



1-3 



Idle count F-4.5 

IDLE status 4-15 

Implicit permission 

IN parameter F-7 

Indirect access files 3-3; 4-25; 5-1 

Input device F-7 

INPUT file 3-2 

Input line 

Correction 1-4 

Deletiai 1-4 

Length 1-3 

Multiple logical lines 

Null F-6 

Paper tape 9-3 

Termination 1-4 
Input/output conventions 
Input to executir^ program 1-5 
Inserting statements in program 
Interactive Debug 4-19 
Interlock 5-6 
Interrupt an executing program 

6-4; F-4 

Interrupt program output 1-6; 6-4 
Interruption character 1-6; F-4 
Interruptiwi sequence 1-6; F-4 



Job 

Name 4-20,21; 7-2 
Processir^ commands 4-11 
Status 4-15,19,21.30 
Step limit 4-29 
Suspension 6-4; F-4 
Termination 6-4,5; F-4 

JOB statement 7-2 



6-1 



1-6; 



KCL 4-13 
Keyboard device 
Keyword 5-2,13 



F-7 



LCM and ECS differences vi 

Leader 9-3,4 

LENGTH command 4-22 

Length of input/output lines 1-3 

U parameter F-5 

LIBRARY command 3-3; 4-23; 5-1,8,10,24 

Limits 

Resource 4-20 

Validation 4-35 
LIMITS command 4-23,35 



Line 

Correction 1-4; 6-1 

Deletion 1-4; 4-2; 6-1 

Folding H-6 

Insertiwi 6-1 

Length 1-3 

Multiple F-2 

Numbers 3-4; 4-3,26; 6-2; 7-3 

Speed 2-2,5 

Termination 1-4 
Line feed (LF) 9-3; G-1,2 
Line feed idle count F-5 
LIST command 3-6; 4-23 
LNH (list-no-header) command 4-24 
Loader information 4-20 
Loader sequences 8-2 
LocalfUe a-a,a 
Local file status 4-20,22 
Local mode 9-3 
Local operation F-7 
Locked file 4-22 
Logical file 3-1 
Logical record 3-1,6 
LOGIN command 2-10; 3-8; 4-24; 5-8 
Login procedure 2-1,3 
LOGOUT command 2-10; 3-8; 4-24; 5-8 
Logout procedure 2-10 
LOP F-8 

Lowercase letters 4-2,3 
L072 control statement 8-2 



Magnetic tape limit 4-35 

Mass storage devices 5-4,15; D-1 

Maximum length 

Batch control statement 8-1 

Command 4-2 

Input line 1-3 

Output line F-5 

Page length F-5 

Submit file line 7-5 
WWG&- 4-37 
Message 

Current job status 4-19 

Dayfile 4-15 

From operator 1-4 

Terminator 9-3 

To operator F-7 

To terminal 4-17 
Message command F-7 
Message control system 4-37 
Messages 1-3,4; B-1 
Minimum number of characters in command 



lndcx-4 
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Modification count 5-18 

Modify mode 5-3 

MS command 1-4; F-2,7 

Multifile file 3-1 

Multiple logical input lines F-2 



NA keyword 5-6,7,17 
NAM 2-7; H-1 

ND keyword 3-8; 4-24,25; 5-6 
Network 1-1 

Commands 1-1; F-1 

Messages 1-3 

Terminal A-7 
Network access method 2-7; H-1 
Network connection to terminal 2-1,2 
NEW command 4-24; 5-8 
NEW UNE key v; G-1,2 
New time-sharing record 4-15; A-7 ,8 
No abort 5-6 
No drop 3-8; 4-24,25; 5-6 
Nonallocatable devices 4-37 
NORMAL command 4-5; A-1,2 
Normal mode 4-5; A-8 
NOSORT command 3-5; 4-25 
No-timeout terminal 2-10; 4-5,37 
NULL command 2-7; 4-10 
Null input line F-6 
Null mode 5-4 
Null permission 5-4 
Null subsystem 1-3; 3-4; 4-10; 5-4 
Numeric conventions 4-2 



Object code 4-8,27 

Octal codes A-2 

Off-line punching 9-1 

OLD command 3-3; 4-25; 5-1,8,10 

Old time-sharing record 4-15; A-7 ,8 

On-line punching 9-4 

OP parameter F-7 

Output device F-7 

OUTPUT file 3-2 

Output interruption 1-6; 6-4 

Output Unes 1-3; 8-2; F-5 



PA parameter F-6 
PACK command 3-7; 4-25 
Pack a file 3-7; 4-25; 7-3 
PACKNAM command 5-11 
Packname 4-20; 5-5,16 
Page boundary 1-5; 4-15; F-5 
Page length F-5 
Page wait 1-5; F-5 



P^e width F-5 
Paper tape 

Control characters 9-2 

Corrections 9-4 

Input lines 9-3 

Mode 9-3 

On-line punching 9-4 

Operations 9-1 

Output 9-4 

Punch F-7 

Punching 9-3 

Reader F-7 
Parity bit F-6 
Parity selection F-6 
Parity switch 2-2 
PASSWOR command 4-26 
Password 2-6; 4-26; 5-3 
Password parameter 5-3 

PpPOPnt nhonortfow A_0 

Permanent file 

Access 5-1,10 

Append file to 5-7 

Attach 5-7 

Catalog 5-1 

Category 5-3 

Change 5-8 

Command format 5-2 

Commands 5-1,7 

Creation 5-1,9 

Direct 5-1,2 

Family (refer to family name) 

Granting access 5-11 

Indirect 5-1 

Limit 4-35 

Mode of access 5-1,3 

Name 5-2,14 

Permission mode 5-3 

Release 5-8 

Remove 5-12 

Replace 5-12 

Residency 5-4 

Retrieve 5-1,10 

Size 5-1,2,5 
Types 5-1,2 
Permission 5-3,11,12,13,21 
Permission information 5-13 
Permission mode 5-3,7,18 
PERMIT command 5-12 
pfn 5-2 

PG parameter F-5 
Physical lines as page F-5 
Physical record units 3-1 
PL parameter F-5 
PRIMARY command 3-3; 4-26 
Primary file 3-3; 4-20,23,24,26,27 
Print file limit 4-36 
Printer F-7 
Private file 5-3 
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Private file access 5-21 

Procedure file usage 4-11,13,32; 8-2 

Program editing 6-1 

Program execution 4-8,27 

Program input 1-5 

Program interruptiOT 1-6; 6-4; F-4 

Program termination 1-6 

Project number 2-9; 4-14 

PRU (physical record unit) 3-1 

PRU limit 4-35,36 

Public file access 5-24 

PubJic files 5-3,24 

PUNCH 3-2 

Punch file limit 4-36 

PUNCHB 3-2 

Punching a paper tape 9-1,4 

PURGE command 5-12 

PW parameter F-5 

P8 3-2 



Question mark 1-5 
Queue priority 4-20 



RBF 4-37; 7-1 
Read file 7-4 
Read mode 5-3 
Read operaticxi 3-1 
Read-only permission 5-1,3 
Read with append mode 5-4 
Read with modify mode 5-3 
Record 3-1 
Records, pack 4-25 
RECOVER/CHARGE 2-7,9 
RECOVER command 2-7; 4-26; 6-7 
RECOVER/SYSTEM 2-7 
Recovery 2-7; 4-26; 6-4,7 
Reformatting directives 7-3 
Reformatting a file 7-2; 8-2 
Releasir^ local files 3-8; 4-15,26,27 
Releasing permanent files (refer to 

PURGE command) 
Remote Batch Facility 4-37; 7-1 
Remote job submittal 4-30; 7-1 
Remove file 5-12 
Remove line numbers 7-3 
RENAME command 4-26 
REPLACE command 5-12; 7-6 
Requesting system information 4-19 
RESEQ command 4-26; 6-2 
Resequcncing line numbers 4-26; 6-2 
Reserved file names 3-2 
Residency of files 5-4 
Resource limits 4-20 
Resources 4-20,30 



Restricted control statements 8-1 

Resume job execution 6-4 

RETURN command 3-8; 4-26; 5-8 

RETURN key v 

Returning files 3-8 

REWIND command 4-27 

Rewind file 7-5 

RFL control statement 8-1 

RNH (run-no-header) command 4-27 

RO key 9-3 

Rubout 9-3 

RUN command 4-19,27 



SAVE command 3-3; 4-9; 5-1,12 

Sep 4=37 

SCR 3-2 

SCRx 3-2 

SE parameter F-6 

Secure memory 8-2 

Security count 7-2; 8-3 

Semiprivate file 5-3,23 

SEND key v 

Set time limit 4-29 

SETASL command 4-28 

SETJSL command 4-29 

SETTL command 4-29 

S,nnnn 6-5 

SORT command 3-5; 4-29 

Sort flag 3-5; 4-24,29 

Sortii^ files 3-4; 4-25,29 

Source prc^ram 4-9; 6-1 

Special editing F-6 

SRU 2-10; 4-14,20 

Account block limit 4-28 
Job step limit 4-29 
Limit 4-36; 6-4,5 
Status 4-15,19,20,21 
STATUS command 4-30 
Stopping a runnir^ job 6-4 
SUBMIT command 4-30; 7-1 
Submit error processing 7-10 
Submit file 7-2 
Subsystem association 3-4; 4-7,10; 

5-4,12,18 
Subsystem descriptions 1-2,3 
Subsystem flag 3-4 
Subsystem parameter 3-4; 5-4,12 
Subsystem selection, automatic 2-9; 3-4; 

4-35; 5-4,12 
Subsystem selection commands 2-7; 4-7; 

8-2 
SUMMARY command 4-30 
Suspend job 6-4 
Switch checking (login) 2-2 
Switchii^ applications 2-10 
System v 
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System control point 4-37 
System file 4-22 
System information 4-19 
System logical record 3-1 
System origin status 4-37 
System resource unit (refer to SRU) 



TAF 4-37 

Tape leader 9-3,4 

Tape mode 9-3 

Tape, paper 9-1 

TAPEl 7-4 

TC parameter F-2 

Teletypewriter operation 9-1 

TELEX/IAF differences H-1 

Temporary files 3-3; 5-1 

Terminal 

Character code set 2-5; F-8 
Characteristics 1-2; 4-5,6; F-1 
Class parameter F-2 
Classes 1-1,2; F-1,2 
Communication 4-7,17,33 
Connection to network 2-1,2 
Control characters F-1, 3 
Control commands 4-3 
Definition commands F-1 
Definition parameters F-2 
Identification 2-4 
Messages B-1 
Name 2-5 

Number 2-7; 4-33; 6-7 
Session 2-10 
Status 3-6 
Timeout 4-5,37 
Types A-7 
Terminal Verification Facility 4-37 
Terminate 

Executing program 1-6; 6-5; F-4 
Input line 1-4 
Job 6-4 
Output 1-6; 6-4 
Program 1-6; 6-4 
Terminal session 2-10 
Termination character 1-6; 6-5; F-4 
Termination sequence 1-6; 6-5; F-4 
TEXT command 4-30 
Text Editor 4-18; 6-1 
Text Editor commands E-1 
Text mode 4-30 
Time limit 4-29; 6-4,5 
Timeout 2-10 
TIMEOUT command 4-5 
Timeout, transparent mode F-6 
Time-sharing messages B-1 
T,nnnn 6-5 
TO parameter F-6 



THAN command H-3 
Transaction Facility 4-37 
Transaction functions 4-37 
Transmission block F-2 
Transmission key v; G-1 
Transmit information G-1 
Transparent input mode delimiter F-6 
Transparent mode 7-3; 9-3; A-9; F-2,6,7; 

H-1 
TRMDEF command 4-5; G-1 
TVF 4-37 
Types of files 4-22 
Types of permanent files 5-1,2 



Unsuccessful recovery 6-7 

Uppercase letters 4-2,3 

usep access 4-2 

User break 1 sequence 1-6; F-4 

User break 2 sequence 1-6; F-4 

USER command 4-33 

USER control statement 7-2; 8-3 

User index 4-20; 5-18 

User name 4-20; 8-3 

Entry of 2-6; 8-3 

Parameter 5-2,15 
User number 2-6; H-3 



Validation limits 4-2,23,35 
Virtual network terminal A-7; H-1 



WAIT status 4-15 

Working (temporary) copy of file 5-1 

Write interlock 5-2 

Write mode 5-2,3,7 

Write operation 3-1 



X.ccccccc 8-2 
XEDIT command 4-33; 6-1 
XEDIT commands E-2 
X-off character 9-3 



ZZZDUMP 6-12 
ZZZZZxx 3-2 



-pname 4-11,34 
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Command 

LNH 

LOGIN 

LOGOUT 

NEW 

NORMAL 

NOSORT 

NULL 

OLD 

PACK 

PACKNAM 



PERMIT 

PRIMARY 

PURGE 

RECOVER 

RENAME 

REPLACE 

RESEQ 

RETURN 

REWIND 

RNH 

RUN 

S 

SAVE 

SETASL 

SETJSL 

SETTL 

SORT 

STATUS 

SUBMIT 

SUMMARY 

T 

TEXT 

TIMEOUT 

TRMDEF 

USER 

XEDIT 

-pname 



Description 

Lists a file (without header) 

Same as HELLO command 

Same as BYE command 

Creates new primary file 

Clears ASCII, AUTO, BRIEF, CSET, and NOSORT commands 

Prevents automatic sortir^ of primary file 

Selects null subsystem 

Retrieves copy of indirect access permanent file for 

use as primary file 
Compresses logical records of file into one logical record 
Directs permanent file requests to specified auxiliary 

devices 
Changes user's password 
Grants explicit private or semiprivate file access 

permission 
Makes a temporary file the current primary file 
Removes specified permanent file(s) from the system 

^.^.vu.iivu ^t v^^votjiii^ cti. ici bjr:M.^iii ujaCuilltculimi 

Changes name of temporary file(s) 

Replaces contents of indirect access permanent file(s) 

with contents of temporary file(s) 
Resequences or adds line numbers 
Releases local file(s) 
Repositicms file(s) to its beginning 
Runs a program (does not print header) 
Runs a program (prints header) 
Increases SRU job step limit 
Creates indirect access permanent files 
Sets SRU account block limit 
Sets SRU job step limit 
Sets time limit 
Sorts a file with line numbers 
Same as ENQUIRE command 
Allows remote batch job entry 
Lists resources used during session 
Increases CPU time limit 
Selects text mode 

Changes no-timeout terminal to standard timeout status 
Changes terminal characteristics 
Supplies terminal number of specified user 
Selects XEDIT 
Same as BEGIN command 
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4-24 



4-24 
4-5 
4-24 
4-10 

4-25; 5-10 
4-25 

5-11 
4-26 

5-11 
4-26 
5-12 
4-26 
4-26 

5-12 

4-26; 6-2 

4-26,27 

4-27 

4-27 

4-27 

6-5 

5-12 

4-28 

4-29 

4-29 

4-29 

4-30; 7-1 

4-30 

6-5 

4-30 

4-5 

4-5 

4-33 

4-33 

4-34 



